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at IBM sys i : aha E. to othar 


em Engineers S shown 


information only. 


IBM gives no warranty nor makesS any representation as 
accuracy of material in the publication, nor does it 
liability of any kind whatsoever arising out of the 
this document. 
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This document contains information believed accurate 
and current at the time of publication, with regard to 
DOS/VSE Release 1 and VSE/Advanced Functions Release 1 
and related IBM licensed programs. The reader should 


be aWare that subsSeguent Changes either to 


the 


hardware features or to the above mentioned software, 


plans to provide update information on changes 


enhancements through the normal wISC distributions. 
However, this DAPS version of the the DOS/VSE Planning 


Guide with anformation on DOS/SVYSE Release 1 


and 


VSE/Advanced Functions Release 1 w#ill not be updated. 
Instead, the next edition of this Guide will contain 


specific planning information on details 
VSE/Advanced Functions Release 2. 
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This Technical Bulletin is an "IBM Internal Use Only" document 
and, therefore, its use is confined to IBM employees. The intent 
is to provide insight into the capability of IBM products for IBM 
Marketing Representatives and Systems Engineers. 


This document has not been subjected to any formal review and 

has not been checked for technical accuracy. Results must be 
individually evaluated for applicability to a particular installation. 
You may discuss pertinent information from this bulletin with 

a customer, and you can abstract pertinent information for 
presentation to your customers. However, any code included is 

for internal information purposes only and may not be given to 
customers. If included code is identified as "incidental 
programming," its use must conform to the guidelines in the 

relative section of the Sales Manual. 


The products referenced in this document may not be available in 
all countries. 


Any performance data contained in this document was determined in 
a controlled environment; and therefore, the results which may be 
obtained in other operating environments may vary significantly. 

Users of this document should verify the applicable data in their 
specific environment. For this reason performance data contained 
in this document may not be abstracted and/or given to customers. 
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This guide is the result of a WTSC Boeblingen project, and 
is intended as a reference docusent to help Systems 
Engineers plan a customer's installation in terms of the new 
DOS/VSE related software. 


The information contained in this document should eliminate 
duplicate fact finding efforts normally carried out for each 
customer installation. 


The objectives of the Guide are as follows : 


(1) Provide planning information required for 
established customers migrating to new versions of 
IBM software. 


Planning information is provided, where possible, 
for the use of new functions and the design of 
applications/systens exploiting these new functions. 


Information is also provided to enable the Systems 
Engineer to prepare for the installation of, and 
Migration to, the new version of the individual 
software component, in an efficient manner. 


Productivity benefits, compatibility information, 
performance implications and exauples of use of new 
functions are given where appropriate or necessary. 


(11) Provide functional information for the Systems 
Engineer which may be valuable at proposal time for 
a potential first time user of a software product. 


This is really a by-product of the Guide, but should 
be of value to Sales Representatives marketing these 
benefits of new version/releases of IBM software. 


(211) Provide self education for the Systems Engineer on 
the use and exploitation of new functions in DOS/VSE 
related software. 
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(iv) Provide a Summary list of all available product 
reference material for the individual software 
components. | 


(v) Provide an overview of the various DOS/VSE system 
offerings and their potential value to the DOS/VSE 
customer. 


(vi) Provide valuable material for the Systems Engineer 
| | Which can be used in customer presentations on new 
functions of the various DOS/VSE software 
components. | - | 
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This is the second edition of this Guide and has been 
specitically produced to support planning and installation 
of the new 4300 range of machines as Wweli aS DBOS/VSE and 
related software. Note also though, that DOS/VSE related 
information 15 also given for System/370 and 3031 hardware 
where relevant. Finally, Chapter 3 will also give a brief 


overview of the line items provided by VWSE/Advanced 
Functions Rel 2 in 12/79. However, a new edition of this 
Guide will be released later, containing specific 


information about the new facilities of VSE/Advanced 
Functions Rel 2. 


fhe DOS/SVSE Planning Guide is logically divided into three 
parts contained in two separate volumes, 

Volume I ({ 2210-9825 ) contains part i (DOS/YSE Basic 
Control Functions) and Volume If (2210-9826) contains parts 
1i and iii (DOS/VSE related licensed programs and DOS/YSE 
system offerings). 

The three parts are :; 


VOLURE I 


Part 1 : DOS/VSE Basic Control Functions 


The purpose of this part is to describe the 
enhancements and new Features of the various DOS/SYSE 
basic control functions. These include: 


° DOS/VSE SCP (5745-020) (Chapter 4) 
* VSE/Advanced Functions (5746-X28) (Chapter 4) 
° VSE/VSAM (5746-AM2) (Chapter 5) 
» VSE/POWER (incl. RJE) (5746-XE3) (Chapter 6) 
* ACF/VTAME (5746-RC7) (Chapter 7) 


With 


regard to descriptions of new functions, 


the 


topics discussed generally address the following areas 
of interest ; 
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(a) 
(b) 
(c) 
(da) 
(e) 


(£) 


What are the new functions? 

How and when should they be used? 

How are they iaplemented? 

Examples of use of the new functions. 
Compatibility information with regard to 
conversion from previous releases of the software 
component in question and with regard to 


other interfacing programs. 


Performance implications of  $ainstallation of 
new functions. 


Besides descriptions of new functions, the following 
aspects have also been considered ; 


(a) 


(b) 


where it is known that a particular topic is 
either not well documented in other manuals, or 
is of special interest to the field, additional 


information may be provided. For example, in 
Chapter 4, a Special section has been included on 
Multi-CECc (or Malti-CPU) considerations to 


describe exactly what is supported under DOS/VSE 
at the present time. Of course, the next edition 


of this Guide, being oriented towards 
VSE/Advanced Functions Rel 2 details, will 


contain alot more information on this aspect 
because of the greatly enhanced DOS/VSE support 
of DASD sharing contained in the VSE/Advanced 
Functions Rel 2 licensed progran. 


Within each topic, tables Summarizing what has 
been discussed, are included where relevant. For 
example in the topic that discusses DASD support 
under DOS/YSE, a table Summarizing this support 
has been included. | | 


With some topics discussed in the Guide, no new 
features or functions have been provided by 
DOS/VSE aS compared to DOS/VS Release 34. These 
topics have been ancluded for the sake of 
completeness or to set up a topic for update in 
future editions, 
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Part i1 : DOS/VSE Related Licensed Programs. 


The purpose of this part is to describe supporting 
information for the Systems Engineer on a number of 
SPL (Selected/Standard Product Line) software 
components. [It is intended to update this part in 
future editions of the DOS/VSE Planning Guide to 
include valuable planning information on the major 
strategic products in the IBM product line, 
particularly as new versions/releaSesS are announced. 


The software components discussed in this edition of 
the Guide are: 


(a) Data BaSe Function Group (Chapter 8) 
* DL/I DOS/VS (5746-XX1) 

(bo) Data Communications Function Group (Chapter 9) 
‘ CICS/VS (5746-XX3) 

(Cc) DOS/SVSE Programming Pacilities | (Chapter 10) 
° RPG II (5746-RG1) 
+ DMS/CICS/VS (5746-XC4) 
. SORT/MERGE Version 2 (5746-SH2) 

(4) DOS/VSE Interactive Function Group (Chapter 11) 
> VSE/ICCF (5746-T51) 

(e) DOS/SVSE Data Security Facilities {Chapter 12) 
* VSE/ACCESS CONTROL - LOGREP (5746-XE7) 


Not all of the above products have been discussed in 
detail, but where possible, the following topics have 
been discussed (especially for DL/I, cicsyv¥s and 
VSE/ICCF): 


(a) Description of product function. 


{b) Dbescription of enhancements and use of the latest 
release of the software product. 


(Cc) Installation and migration considerations of the 
latest release of the software product. 


WISC BOE IBM Internal Use 1.7 


Chapter 1.2 DOS/VSE PLANNING GUIDE 
Introduction Volume II 2210-9826 


(d) Summary of ali the product reference material, 
available to the Systems Engineer. 


Part 111 : DOS/YSE Software System Offerings. 


The purpose of this part (Chapter 13), 15 to describe 
the benefits of the various offerings and include 
relevant information for the Systems Engineer on the 
following: 


(a) Objectives of each offering. 
(b) Components of each offering. 


This Guide will place emphasis on the native/complex 
DOS/VSE System Offerings. In other words, those 
offerings which include VMN software, will not be 
addressed here. [t iS intended to document useful 
installation experience on the non-VYS offerings as 
soon aS it becomes available. 


lee. | IBM Internal Use WESC BOE 


DOS/VSE PLANNING GUIDE Chapter 13 
Z2Z10- 9826 Volume ITI Tntroduction 


(i) the DOS/VSE Planning Guide, is aimed at the 


intermediate systems DOS/VSE user (optionally 
co-existing under VM/370). This includes entry level 
users. 


It is assumed that the customer has been identified as 
such, before this Guide 18S consulted. 


(11) fhe software products discussed in this DOS/VSE 
Planning Guide, are products Specifically supported by 
WESC Boeblingen. VM software does not fall into this 
category So no emphaSis will be placed on YM planning. 


(i111) Finally it should be pointed out that this Guide, 
being the second in the series, attenpts to repeat as 
little as possible, what has already been expressed in 
the first edition. Consequently, frequent references 
are made to the first edition, its DAPS number being 
ZZ10-9822-00. Therefore, it is suggested that the 
reader creates a library of DOS/VS and DOS/VSE 
Planning Guides, so that all referenced topics may be 
readily accessible when required. 
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CHAPTER 2 


NEW SYSTEM ARCHITECTURE 


(Refer to Volume I for this Chapter) 
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CHAPTER 3 


DOS/VSE STRUCTURE 
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3-1 OVERALL CONTENTS 


According to the 4300 processors and DOS/VSE announcement of 
1079, DOS/VYSE will be composed of the following components: 


DOS/VSE SCP 
VSE/Advanced Functions (Releases 1 and 2) 
VSE/VSAM (Releases 1 and 2) 
VSE/POWER (Releases 1 and 2) 
VSE/ICCF Release 1 
BTAM-ES or VTA (ACF/VTAME or ACF/VTAM) 
Job Entry Program (JEP) and File Transfer Program (FTP) 
Languages, Sorts, and Utilities 
- includes DOS/VS RPG II (Release 3) 
* Emulators | 
- includes [BM Systems 1401/1440/1460 Emulator Progran 
Release 1 
, DB/DC program products 
* Other Licensed and Application Programs 


ee 6 &© © € « & (UF 


Notes: 


En cr a aE 


- Only the DbDOS/VSE SCP will be free of charge. All other 
components are Licensed Programs, and therefore will be 
Charged for. 


- The System Utilities and Standalone Utilities are part of 
DOS/VSE. 


- The ASSEMBLER is part of DOS/VSE 
- Do not forget that a an IR for 3800 printer support still 


exists. It 18S called the VSE/IBM 3800 Printing Subsystea 
IR, program number 5747-CC1. © | 
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components require VSE/Advanced Functions (ADV. 


FUNCT. in above diagram) aS a prerequisite product. 


® The VSE/ACCESS CONTROL - LOGGING AND REPORTING (ACC. 
CNTRL. in above diagram) requires VSE/ICCF Rel. 1 as a 
prerequisite product. 


° The ASSEMBLER is part of DOS/SYSE. 


* The 


System and Stand-alone Utilities are part of 


DOS/VSE. 


° The following components will have new Releases: 


* All 
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VSE/Advanced Functions Rel 2 

VSE/POWER Rel.2 

VSE/POWER SHARED SPOOLING FEATURE 

VSE/VYSAM Rel.2 

VSE/VSAM SPACE MANAGEMENT FOR SAM FEATURE 

VSE/FAST COPY DATA SET PROGRAM Rel.1 (this is the 
first availability of this licensed progran) 

Job Entry Program (JEP) and File Transfer Program (FTP) 


otier components will be at the DOS/VSE o/79 level. 
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The DOS/VSE SCP is available alony with a priced extension - 
VSE/Advanced Functions, which is required for runniny all of 
the other products. 


The following line items make up the enhancements 
incorporated in the DOS/VSE SCP: 


Hardware Support 
- 4300 Processor Support 
- /370 Support 
- Full 3031 Support 
- Support of High Resolution Timer 
~  FBM Support 
~ Extended AP-1 Program Support For 3310,3370 DASD 
- 3880-33xx / 3370 support 
- 8809 Support 
- 3800 ICR Inteygration 
- 3289-4 Printer Support 
- 3203-5 Printer Support 
- 3278-2A Support (in 3277 Compatibility Mode) 
- Improved Console Printer Support 
- 5424 Support 
- Common EREP (OS Compatible) 
* Removal of Restrictions 
- More LUBS/Partition 
- Less Copy Blocks for CCW-Translation 
- Extent Information removed from JIBS 
* Operational Improvements 
- Improved SVA Briny-up 
- DASD Volume Recognition 
- VOLUME Command 
- Improved 'LISTIO!? 
- Remove X'...' in IPL and JCL 
- Continuation.of Commands/JCL Statements 
- Cancel Mount Requests | 


“ t 
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- Automatic 1403U UCB Load 
- COPYSERY (COPYSORT) Integration 
* Performance Enhancements 
-~ IORE Concept 
- Alternate Path I/O for DASD 
- Improved Load Levelier 
-~ Fast CORGZ 
- EOJ 
- Console Buffering for CRT Consoles 
»* Improved Problem Determination / Installation 
~ DUMPS in SVA 
- Other DUMP Improvements (PDUMP) 
- OLTEP Partition Independence 
- SDAID Improvements / PDAID Removal 
~  ESHP 
* Job Accounting Improvements 
- Use of CPU TIMER 
- Suppress SIO Counting for GENERIC ASSIGN 
- Repeatable ‘Times’ 
- Change in JOBACCT Table 
* Miscellaneous Enhancements 
- Pageable Supervisor (optional) 
- Reduced Supervisor Options 
- Subsystem Identification Support 
- Label Area Support 
~ New Parameters in CPTION Statement 
- Operator Communication for VTAM 
- GETVIS for Real Partitions 
- TOS RaS Support 
- New Parameter in DLEL Statement 
- Reentrant Supervisor Communication Macros 


SCP - ASSEMBLER 


- Support of ECPS:VSE instructions 
- Short Cross Reference List 

- Support of Lony SETe 

- FBM Support of Worktiles 


SCP - STANDALONE UTILITIES 


ee OO eee ——— a em eu quae atute ee Wily eee aus aide A i ahem a eae cee anne Wane ee 


General - Tape Only 

New Utiiities 

~ Surface Anaiysis (FBS) 

- Format Emuiated Extent 
* Chanyed Utilities 

- [Initialize tisk 
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, Restore | System 
> ‘Fast Copy Disk 


SCP - SYSTEM. OIELETIES 


* New ueevities: 7 
= Assign Alternate Block 
= Printer Train oleae 
* Changed Utilities 
= “Backup Systen 
- Restore Systen : | 
- Copy and Restore Diskette 
- OBIMAINT 
- Fast Copy Disk (CKD and Fea) 
7 Tnitialize. Tape 
= Initialize Disk | | 
= Print HARDCOPY File (PRINTLOG) 
= ne oes ae ca 


= QTAM Support ok Ge -_ _ 

- System /360 Mod. 20 Emulator 

- 2321 Data Cell Support | 3 
= 2495 Tape Cartridge. Reader Support 

= Deblock Utility — 

7 Copy/Restore Disk. Or Data Cell 

- P£FHIST and HISTLIS? Utilitie Ss 

- Supervisor Seek Separation | 

7. BDAID- | _ 7 
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| 3.3.25 "WSEZADVANCED FUNCTIONS 


: “¥SE/Advanced. Functions Weveaea s 1 and 2 are the successors 


o> Ok the ADVANCED 'FUNCTIONS=DOS/VS Licensed program which was 
provided along with DOS/VS Release 34. “the Release 34 
one are retained and new functions are provided. 


Pine only pre-requisite for instalting VSE/Advanced Functions 
is that the customer must have already installed DOS/VSE. 


The cus stomer must be aware that SuStailatics of VSE/Advanced 


Bedok is) mandatory before any IBM licensed fae Bay: 
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The followiny line items make up the enhancements 
incorporated in the VSE/Advanced Functions Release 1 


product: 


‘ 


Operational Improvements 
- Implicit Invocation of Linkage Editor 
- Keep Messages with Outstanding Reply 
- Automatic System [Initialization (AST) 
- LBLTYP Statement Elimination 
* Performance Enhancements 
~ Fast CCW-Translate Switchable by JcCL 
-~ High Level SDL Search 
- Fast sb-TranSient Fetch 
- Fast C-Transient Fetch 
- Fast Open of HARDCOPY File 
- Multiple Extent Page Data Set 
- Jmprovement of OPTION Statement 
» Other Improvements 
- Area for Job-to-Job Communication 
- Label Area aS Separate Data Set 
- Support of 7 Partitions for 3340 SYSRES 
- Dump Improvements 
* YMLE Enhancements 
- Support of 3310 and 3370 in System/370 Compatibility Mode 


fae following iine items make up the enhancements 
incorporated ain the VSE/Advanced Functions Release 2 
product: 


* Functional Description 
- SYSLOG on SYSLST (LISTLOG) Utility 
- Additional CLEL Tnformation 
-~ Dynamic Device Assignment 
-~ SYSENK in VSAM Managed Space 
- Extended Volume Command 
- Support of Yolume Mount Requests 
- Shared Libraries 
- Concatenated Libraries 
- Multiple Procedure Libraries 
- wpASD Sharing Across Systeas 
- 6-Transient Contention Removal 
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- General Services for IBM Components 
- More Partitions / More Tasks 

~ System Tailoring at IPL 

- New Label Area Support Functions 

~ On-line SYSGEN under Rel. 1 Control 


The DOS/VSE Time Sharing System ( VSEYICCF ) iS an extension 
of the ETSS FDP's and is now offered as a LICENSED PROGRAM. 
It complements the interactive strategy on 4300 processors 
as well as on System /370. VSE/ICCF provides for interactive 
program development and execution, interactive systen 
operation, and problem soiving. 


Pre-requisites for running of VSE/VICCF are that the 
following products are installed: 


® DOS/VSE 
* VSE/Advanced Functions 


As well as this the user must generate a supervisor with 
'ICCF=YES' in the SUPVR macro, after having anstalled 
VSE/Advanced Functions, Please note that specification of 
"ICCF=YES' forces generation of ‘'FP=YES'; this means that 
the CPU must be equipped with the Floating Point feature. 
Note also, that 1f DOS/VSE data security support 15 also 
reguired (see a later section), then another parameter 
‘SEC=nn' should be specified inthe FOPT macro of this 
Supervisor. 


The following line items make up the enhancements 
incorporated in the VSE/ICCF product ;3 


~ An anteractive facility for DOS/VSE on System/370 and 
4300 processors 

- An online library system to store programs, jobs and data 

- An online source proyram and data entry, update and 
maintenance facility, which enhances program development 
productivity 

- An online library maintenance tool with copy, purge, 
insert, rename and resequence functions, data compression 
Capability, library change control and auditing assist 
functions. This again should enhance productivity as well 

aS adda level of a Security in the DP instaliation 

- A powerful editing function, including a context and full 
screen editor | 

- A direct job execution facility, providing compile, load 
and go compatibilities for all DBOS/VSE language 
compilers, including interactive compilers 


3.8 . IBM Internal Use WTSC BOE 


DOS/VSE PLANNING GUIDE Chapter 3.3 
ZZ10-9826 Volume II Highlights 


A facility to run most existing Single task batch 
programs interactively by submitting terminal 1/0 for 
card input/printer-punch output 

- A submit-to-batch via VSE/POWER, allowing the user to 
initiate jobs from the terminal, for dater batch 
procesSing. Printed resultS may received at the terminal 
or the system printer or both. 

- Interactive usability aids, inthe form of prompter 
facilities to ease creation of bOS/VSE, VSE/POWER and 
VSE/ICCF jobs; ease installation and operation; and to 
lower skill requirements. These interactive usability 
aids are Supported on display terminals of 1920 
Characters or more. 

- System Data Security Aid (Access Control), allowing each 
installation to select the security provisions appropiate 
to its needs 

- A procedure processor with logic capabilities, allowing 
both the installation and the users to build their own 
commands and procedures 

- Dynamic disk space aliocation, freeing the installation 
from having to pre-allocate or pre-define files 

- Support of FBM devices for VSE/ICCF libraries 

- User interface to VSE/ICCF through the IBS 3270 terminal 
System, utilizing such features as full Screen Support, 
projtam access keys, prograM FUNCTION KEYS (for command 
Substitution) as well as forward/backwara paging, 
right/left iine shift and So on 

- The ability to share terminal devices with CICS/VS, thus 
eliminating the need for Separate terminal networks and 
duplicated terminal control functions 

- Storage protection for interaCTIVE PARTITIONS IS STANDARD 


AS in past DOS/VS releases, VSE/POWER provides the spooling 
and job scheduling facilities for DOS/VSE. The VSE/POWER 
SHARED SPOOLING FEATURE (prerequiSites are VSE/AF Rel 2 and 
VSE/PUWER Release 2) and the VSE/POWER REMOTE JOS ENTRY 
FEATURE are added to extend its Co-existence and Remote Job 
Entry capabilities. 


Pre-reguisites for VSE/POWER Release 1 are DOS/VSE and 
VSE/Advanced Functions Release 1, while those for VSE/POWER 
Release 2 are DOS/VSE and YSE/Advanced Functions Release 2. 


The following line items make up the enhancements 
incorporated in the VSE/POWER Release 1 product ; 
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Enhancements vs. Rel.34 POWER/VS 
- FBM Support 

~ Expanded PALTER 

- PHOLD Command 

- Blocked Tape Reader 

- SLI Nesting 

- Page Count Improvements 
~ Offloading of Queues 

- 3800 ICR Integration 

~ 8809 Support 

- Quality Improvements 


The basic VSE/POWER Release 1 system may be extended by the 
installation of a Separately orderable optional VSE/POWER 
Remote Job Entry Feature that allows spooling via remote BSC 
or SNA work stations. The pre-requisites for this feature 
are: / | 


, DOS/VSE 

* VSE/Advanced Functions 

* DOS/VS ACF/VTAM Release 2 (5745-010) - for RJE,SNA 
Support, if 370X control units used. 

® ACF/VTAKME (S746- RC7) - for RJE/SNA Support in the 4331 
ICA. | 


* DOS/VS NCP Version 5.0 (5747-AJ2) - for RJE,SNA Support, 
if 370X control units used. 

® DOS/VS EP (5746-aG1) - for RJE,BSC support, if 370X 

control units used. 


The following line items make up the enhancements 
incorporated in VSE/POWER REMOTE JOB ENTRY FEATURE: 


POWER er amp <a nan eee ete a> [a aan CDN enn eae suai ETS 7 ED ate a emee ane sD 


-* Enhancements vs. Rel.34 POWER/VS 

- Full 3741 Support 7 

~ SNA / Exchange Media Inbound {support for 3760 Data 
Entry Station). | 

-~ Multileaving Support (BSC line connection) 


The following line items make up the enhancements 


incorporated in von cPOnes Release 2 as compared to VSE/POWER 
Release b 
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VSE/POWER RELEASE 2 


- Support of 3262-1 Printer 
~ Support of Extended Number of Partitions 
- Partial support for concatenated libraries (first in 
chain only) 
- VSE/ICCF Interface allowing interrogation of POWER Queue 
etc. 


The following line items Show the facilities provided by the 
VS@/POWER Shared Spooling Facility: 


- Sharing of all or any POWER file(s) petween CEC's (CPU's) 
- Sharing of SLI (Source Library Include) Library 


Note, that there are no new enhancements with regard to RJE 
Support. The VSE/POWER RJE Feature as made available with 
VSE/POWER Release 1 1S again available with VSE/POWER 
Release 2. 


AS in past DOS/VS releases, VSAM provides Data Management 
functions and iS the primary DASD Access Method for DOS/VSE. 
The VSE/VSAM SPACE MANAGEMENT FOR SAM FEATURE expands its 
Space Management capabilities to also support SAM files. 


Pre-requisites for VSE/VSAM Release 1 and 2 are VSE/Advanced 
Functions Release 1 and 2 respectively. Similarly, the 
pre-requisites for VSE/VSAM SPACE MANAGEMENT FOR SAM FEATURE 
are VSE/AF Rel 2 and VSE/VSAN Release 2. 


The Following line items make up the enhancements 


incorporated in VSE/VSAM Releases 1and 2as well as in 
VSE/VSAM SPACt MANAGEMENT FOR SAM FRATURE 3: 


VSEZVSAM RELEASE 1.0 


® Enhancements vs. Rel.34 VSAM 
- No-Imbed for Catalog 
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- Control Interval Split Integrity 

- FBM Device Support 

- Fixed Head Support via Use of Space Classes 
- Support of New Block Sizes 

- EXPORT / EXPORTRA Performance 

- ORB Support 

~ 8809 Support 

- SHOWCAT Macro Improvement 


* Enhancements vs. VSE/VSAM Release 1.0 
~- DASD Sharing 
- Catalog Management Performance Improvements 
- Shareoptions 4 Performance Improvements 
-~ Control Area Split Integrity 
- ANS CANCEL Command 
- Serviceability Upyrade (User Exit Facility for 
De-bugging) 
- VSAM Space Management and Usability Enhancements 


As for BTAN SCP in DOS/¥YS Release 34, BTAM-ES provides 
teleprocessing control program support for communication 
between a host computer and a variety of start-stop, BSC and 
ijocal channel attached terminals. The function of BTAM-ES 
has not been enhanced over DOS/VS Release 34 BTAM, but 
BTAM-ES will operate on 4300 processors and minor changes 
have been incorporated to allow proper interfacing with 
DOS/SVSE. 


Because BTAM-ES iS substantiaily the Same aS it was in 
DOS/VS Release 34, no further details will be provided on 
this progran in this Guide. However, the following 
migration considerations should be noted for the customer 
moving to BLAM-ES ; 


- fhe BIMOD macro must be re-assembled and re-linked. This 
1S mandatory. 
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- For native BLAM users, it is suggested that application 
projrams be re-compiled, so as to obtain the benefit of 
the latest maintenance level of the BTAM macros. However, 
it iS possible that re-compilation of such application 
programs, may not be mandatory. Therefore, WTSC 
Boeblingen will investigate the alternatives and document 
Clarification of this aspect ina later WTSC Boeblingen 
bulletin. 


- Finally, for migration considerations with respect to 
CICS/VS users, the appropirate CICS/VS chapter later in 
this Guide, should be referenced. 


3-3-/ JOB ENTRY PROGRAM (JEP) AND FILE TRANSFER PROGRAM 
(FTP) 


The Job Entry Program, referred to aS JdJ£P, provides’ the 
basic interconnection mecnanism between a DOS/VSE SUBHOST to 
a job entry subsystem HOSY. It oifers job submission from a 
SUEHOST to a job entry Subsystem at the HOST and routing of 
job output back to the originating SUEHOST or to an 
alternate destination. JEP communicates with the following 
job entry subsystems at the HOST: 


OS/VS2 JES2 

OS/VS2 JES3 

OS/¥S2 NJE/JES2 

OS/VS1 RES/SIJES 

DOS/S¥SE with VSE/Advanced Functions, 

VSE/POWER, and VSE/POWER REMOTE JCS ENTRY FEATURE. 


* ¢ ¢ 6 @ 


Note, that pre-reguisites for JEP are: 


* DOS/SVSE with VSE/Advanced Functions 

* VSE/POWER 

e ACF/VTAM with MSNF {or ACF/VTAME aif JEP is resident in 
the 4331 processor) 


Be aware though, that JEP does not preciude the co-existence 
of VSE/POWER REMOTE JOB ENTRY FEATURE. In fact, with the 
VSE/POWER REMOTE JOB ENTRY FEATURE installed, JEP otters the 
Capability ior SNA workstations and BSC terminals connected 
to VSE/POWER in the DOS/VSE SUBHOST, to Submit jobs through 
the SUBHOST to the HOST. 


The Fale Transfer Program, referred to as FIP, expands the 
capabilities of JEP. Together with JEP, the FIP installed at 
the HOST, otfers capabilities required to centralize progran 
maintenance activities to the HOST, thus Saving the user the 
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cost of keeping programmer teams at each subhost location. 
With JEP and FEP, jobs can be submitted from the HOST to the 
SUBHOST, and the job output can pe transmitted back to the 
originating HOST or to an alternate HOST system. AS Well as 
this facility, with FTP installed at both the HOST and 
SUBHOST, JEP and FTP offer transmission of sequential files 
between the DOS/VSE SUBHOST and the HOST in both directions. 
The file transfers may be initiated in one or the other 
direction, either at the SUBHOST or the HOST. 


The foliiowing line items show the facilities provided by the 
JEP and FTP programs: 


-~ Collection of Data and Periodic Transmission of Jobs 
or Fiies to a HOST Computer for Central Processing 

- fransmission of output data (job output or files) to 
remote locations for processing 

- fransaission of Data Files Between the HOST and 
SUBHOST for Processing at the HOST or SUBHOST 

- Submission of Jobs and Routing of job output from the 
SUBHOST to the HOST and from the HOST to the SUBHOST 
in order to offload the Submitting System (e.g. 
DOS/VSE to DOS/VYSE environment) or to submit OS/¥5 
Jobs at a DOS/SVSE Installation or Submit DOS/VSE Jobs 
at an OS/VS Installation etc, 

- Sharing of the Communications Link among various 
Applications, 

- Co-existence between BSC and SNA Components, together 
with VSE/POWER. 

- Security and Integrity by means of JEP Generation 
Parameters and Authorization Passwords 


This 15 a new program product which provides part of the 
data security functions offered for batch users of DOS/VSE. 
These security functions are designed for auditing purposes 
of a DOS/VSE data processing environment. In particular, the 
following events can be controlled, checked and logged for 
security reasons - data set access, library access, program 
access, user identification and user verification. A 
security loy file is used for storing the logged information 
and a Special report program is provided to allow printing 
of selected data from this file for auditing purposes. 
VSE/Advanced Functions and VSE/ICCF Release 1.0 are 
prerequisites for data Security in DOS/VSE. 


The following line items are the new facilities provided by 
this licensed program: 


Ww 
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- Logging of information about access related events to 
protected resources (Such as data sets, libraries and 
programs) to a Sequential disk data set 

~ Logging (which is optional) is performed by a DOS/YSE 
Subtask attached to VSE/ICCFP 

- Reporting provides a printout of selected data from the 
above mentioned log data set, for auditing purposes 

- Selection criteria is provided to the reporting module 

_ @uring program execution by means of control statements 

~ Several reports corresponding to various criteria may be 
obtained in one program run 

- Access event data may be archived on a tape and restored 
from tape for deferred reporting 

- fhe lojy data set consists of two parts used 
alternatively; one part for logging and one part for 
reporting 

- Bibliography : GH12-5045 - Design Cbjectives 

GH12-5130 - General Information 

SH12-5536 - Program Reference and Operations 
GC33-6077 - Data Security Guide DOS/YSE 
LY12-5032 - Logic 


3.3-2 ACF/VIAME 
ACF/VTAHE 158 a new Licensed Program (program number 


5746-RC7) for users of DOS/VSE. ACF/VTAME Release 1 offers 
support for the Communication Adapters of the 4331 and also 
provides support for the various channel attached devices. 
Key ACF/V2AM and ACP/NCP/VS functions are combined in 
ACF /VTAME. The functions provided by ACF/VYTAME are 
compatible with analogous functions provided by ACF/VTAK 


Release 2. ACF/VTAME provides support for multi-systen 
networking. 
Highlights 
* Support for the 4331 Communication Adapter instead of 
the 3705 communications controller. 
® Support for a variety of devices; 
=. SNA=SDLC 
- BSC 3270 
- SNA and non-SNA channel attached 
Upwards compatible with ACF/VTAM Release 2. 
Allows concurrent use of multiple ACF/VTAME application 
programs. 
4 Controls the Sharing of hetwork resources among 
ACF/VTAME application programs. 
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° Provides for application program to application program 
and application program to terminal Sessions. 

” A multisystem networking capability 1s provided as an 
Integral part of ACF/VTAME functions. 

* Support of CICS/VS 

# Support of the Network Operation Support Program (NOSP) 
LP. 

* Support of the Network Communication Control Facility 
(NCCF) LP and its related Network Problen Determination 
Application (NPDA) LP. 


3-3.10 LANGUAGES, SORTS AND UTILITIES 


Concurrently with the announcement of DOS/VSE, the following 
new languages, sorts and utilities are annnounced and 
covered in this Guide: 


» DOS/VS RPG II Release 3 

* DMS/CICS/VS 

® DOS/YVS Sort/Meryge Version 2 Release 2 
* VSE/Ditto 

» VSE/IBM SYSTEM/3-3340 DATA IMPORT 


Pre-requisites for all licensed programs except DbDOS/VS 
Sort/Merye V¥2R2, are DOS/SVSE and VSE/Advanced Functions. The 
reader should refer to a later section in the Guide for 
Support information With regard to back level DOS/SVS 
releases for the Sort/Merge product. 


DOSZVS RPG If RELEASE 3 


DOS/VS RPG If is a programming languaye that can be used to 
create programs to perform a wide variety of commercial data 
processing jobs. Release 3 of DBOS/¥YS~ RPG II is an 
enhancement of the current DOS/VS RPG II Release 2 compiler, 
Mainly for interactive usage. 


fhe following line items make up the enhancements 
incorporated in the Release 3 product ; : 


- Fixed Block Mode Support 

- Adaptation of the Compiler for VSE/ICCF 

- Adaptation of the compiler for CMS in V8/370 

- RPG IL Source Entry Facility (RSEF) for CMS and ICCF 
-~ DMS/CMS Call Interface Support (CMS) 

~ IFS/CMS Call Interface Support (CMS) 

~ Native Language Text Capability 
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- Error Cross Reference List 


Development Management System/CICS/VS (for DOS/VS) replaces 
DMS/VS (for LOS/VS). This program product simplifies 
application development uSing 3270 IDS. It aids in the 
design and generation of online application programs by 
providing a Simple programming interface to the user. 


The Simplified application development and increased 
programmer productivity can be achived through the 
facilities already known and the following support = and 
capabilities. 


The following line items highlight the facilities provided 
by Release 1 of this product: | 


- All the features os DMS/VS are preserved including large 
screen support. Compatibility is preserved. 

- DMS/YCIcS/YS 1s divided into two components charged 
separately, a base product and an application generation 
feature. 

- Customer Engineering Support. 


The following line items highlight the facilities provided 
by Release 2 of this product: 


- Calculations and edit capabilties to perform simple 
arithmetics (add, subtract, multiply and divide), and 
validate fields. 

- DL/I enhancements to display repeated under repeated 
segments, and variable length Segments. This is available 
for DL/I-DOS/VS not for DL/I-Entry. 

~ Add and Update files and data pases across aultiple 
panels. 


The following line items highlight the facilities provided 
by Release 3 of this product: 


- File and data base Support through CIcs/vVS [Sc (inter 
System Communication facility). 

- RPG-II command level support of FDF (Formatted Data 
Facility). 

- DMS/DBD generation from input supplied by the Data 
Dictionary proyram product. 

- Interactive Application Generation facility to allow for 
Data Definition, Panel Definition and Application 
Definition in an interactive, online environment. 
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DOSZVS SORT/MER 
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This program provides a disk sort which runs under control 
of DOS/VS Releases 33 and 34, as well as DOS/SVSE. 


The following line items make up the enhancements provided 
by this release as opposed to Release 1 : 


~- Execution in both /370 node and E-mode 

- FBM device support for input, output, work and checkpoint 
data sets 

-~ Variable length spanned records for SAM input and output 
files 

- Ability to specify installation unique default values for 
the program options EQUALS, ERASE, DIAG, DUMP, VERIFY, 
PRINT=, ROUTE=, STORAGE=, SORTIN=, SORTOUT= and SORTWK= 

~ SORT or MERGE control fields may overlap each other 

- OUTREC fields can be located beyond byte 4092 of a record 

- When the program is invoked, the control statement images 

are optionally printed if desired 

- When the program is invoked, messages may be routed to a 
pranter other than SYSLST | 

- A new statement, ANALYZE, makeS it possible to receive 
information on how the program will optimize, and what 
Capacity a sort job will have, without actually sorting 
or merging 

- More informative messages and improved diagnostic 
handling | 

- Automatic sequence cCheckiny in sort applications 

- Use of command Chaining when reading SAM input or writing 
SAM output to CKD or tape devices, where sufficient 
Storage iS available. This may enhance performance, 
especially where small input/output blocksizes are being 
used 


WSEZDITTO 


The licensed projyram VSE/DITTO is a combination and 
extension of the FDP's 'HOS/DITTO! (5798-ARN) and 
‘extensions to DOS/DITTO' (5798-CAF). It iS a general 
purpose utility program tor card, magnetic tape and DASD, 
providing a variety of facilities such as listing, copying, 
altering and creating files or portions of files. 


The following line items wake up the facilities provided by 
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this utility program ; 


-~ File to file functions between combinations of SAM, ISAM 
and VSAM, including the ability to create SAM, ISAM or 
VSAN files from tapes, cards or other SAM, ISAM or VSAM 
files. Blocking factors and file locations may also be 
changed 

- Device to console functions, allowing displaying and 
verification of small amounts of tape or BGASD data on the 
console 

~ Card functions to list, copy and interpret punched output 
and pre-punched cards 

- ‘YTape functions to scan, alter, 115t and copy tape files 
or portions of tape files 

- Disk functions to scan, alter, 11st and display DASD data 
Oh a physical address basis, for both CKD and FBS 
devices. On FBM devices, data may be viewed at the block 
level or the control interval level 

- A documentation function provides a program generated 
document of the VSE/DITTO functions and associated 
parameter requirements 


VSE/IBM SYSTEM/3-3340 DATA IMPORT 
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The VSE/IBM SYSTEM/3-3340 DATA IMPORT program 1S a utility 
program that assists the uSer in converting System/3 3348 
data module files into DOS/VSE SAM or VSE/VSAM files. This 
utility runs aS a problem program requiring DOS/VSE and 
VSE/Advanced Functions aS pre-requisites, and requires the 
System/3 - 33480 Compatibility feature on the 4331 processor 
to execute. 


The following line items make up the facilities provided by 
this utility: 


~- Convert System/3 Files on 3348 to SAM and VSE/VSAM Files 

- Muiti-Volume and Multi-Version files may be converted 

- Multiple File Conversion during Single execution of 
VSE/IBM SYSTEM/3-3340 DATA IMPORT 


3-3-11 EBULATORS 


The only new emulator to be announced aiong with DOS/VSE, is 
the IBM Systems 1401/1440/1460 Emulator Program Release 1. 
This program, hereafter referred to as the 1400 Emulator, 
allows the execution of 1400 programs on 4331 processors 


WTSC BCE IBM Internal Use 3,19 


Chapter 3.3 DOS/VSi PLANNING GUIDE 
Highlights Volume II 2210-9826 


eguipped with the 1400 Compatibility Feature, and on 4341 
processors with the 1400 Simulator generated as part of the 
1400 emulator. The Simulation of disk I/0 on FBM devices is 
also provided. Note that the 1400 Emulator runs as a problem 
program under control of DOS Release 26, ODOS/VYS Release 34 
or DOS/SVYSE with VSE/Advanced Functions. 


fhe following line items make up the facilities provided by 
the 1400 Emulator licensed program: 


- Emulation of 14XX with Core Storage up to 16KB 

- Emulation of all Basic Features plus some Optional 
Features 

- Availability of two Tape Formatting Programs with the 
Emulator 


3-3-12 DBZDC PROGRAM PRODUCTS 


The major DB/DC Products in the BDOS/VSE range are CICS 
DOS/VS Release 1.4 and DL/I DCS/VS Release 1.5. Both of 
these licensed programs are covered in detail in later 
chapters in this Guide. 


enhancements in the areas of intersystem communication, 
usability, and device and data baSe support. Additionally 
new facilities provide uSers with the potential to improve 
the application program development productivity. 


Highlights 


CICS/DOS/VS 1.4 provides a wide range of potential benefits 
to users including: 


* ITntersystems communication 
Provides the Capability for communication between 
CICS/VS systems connected by ACF/VTAM. Transactions may 


access files, DL/I data baSesS or initiate transSactions 
or queue mesSages on a connected CICS system. 
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* Entry Level System in CICS/DOS/VS 


An eaSy to use System with following features: Improved 
performance and reduced working set storaye 
requirements, Simplified installation (no SYSGEN), 
Support of HLPI for Assembler, PL/I and COKOL, support 
for DL/I and DL/I Entry and upward compatibility with 
the CICS/DOS/VS system. 


* HLPI ASSENBLER 


This removes the need for Assembler application programs 
to access the CICS/VYS control plocxs. 


» EDF- Execution Diagnostic Facility to assist in the 
testing of application programs written in HLPI. 


° Transaction Restart Facility 


Permits abended transactions to be optionally restarted, 
Without terminal uSer intervention. This feature 15s 
particularily useful in conjunction with Program 
Isolation. 


e Support for the 3270 Information Display System 
enhancements: 
- optional large screen Sizes 
- additional program function keys 
- program attention key on SCS printer 
- Print authorisation matrix 
- magnetic stripe reader 


Enhancements are available via BMS or native terminal 
control. 


* Enhancements of CICS/VS SNA support for the 3774/7 3775 


Supports programmable communications with user written 
function programs in 3774/7 3775. 


° Object and Source code compatibility with cCICS/VS 1.3 
application programs. 


NOTE 


Functions specific to CICS/OS/VS are not listed here. 
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DL/I bOS/VYS 1.5 18 a new release of the proven data hase 
management system called Data Languayge/1l. It will execute 
on IBM 4300 processors or SYSTEM/370'sS operating under 
DOS/SYSE. DL/I 1.5 will also support the 3310 and the 3370 
FBM DASD. | 


The following line items make up the highliyhts provided by 
this new release of BL/I: 


- Support of IBM 4300 processors. ODL/I LOS/VS 1.5 will 
execute on IBM 4300 processors operating in ECPS:VSE or 
/370 mode, operating under DCS/SVSE 

- Support of FBM Devices. Data bases and utility work 
files may reside on the IBM 3310 or IBM 3370 devices in 
FBM mode. This support was made availabie in the DL/I 
DOS/VS 1.4 ICR. 

- All Partition MPS Support. This permits the operation of 
DL/I MPS taSkS to operate one at a time from a VSE/ICCF 
psuedo-partition 

- Field Level Sensitivity. The user programs may ke 
sensitive only to specified portions or a Segment, rather 
than the entire segment 

~ Extended Logical Relationships facility. This support 
permits the definition of multiple logical relationships 
- aS many aS to satisfy the user's needs. This removes 
the current restriction of only one logical relationship 
per hierarchical path 

- Unique segment support. This permits the specification 
of only one occurrence of a segment type for any 
particular parent. 

- Extended SHOWCAT macro Support. This function is used to 
find the high allocated RBA of a VSAM data set. The 
function will be provided by VSE/VSAM as opposed to the 
hard coded logic in previous DL/I releases. 


The major new licensed program that we will nention here, is 
the VSE/IPCS (Interactive Problem Control System) product. 
This product is not covered in detail in this Guide. It 
executes either in a oDOS/VSE batch partition or in a 
VSE/ICCF pseudo-partition, where itS execution may give the 
lmpression of running ‘interactively'. To operate VSE/IPCS, 
commands are entered from either the system console, the 
system input device or a VSE/ICCF controlled terminal. It 
provides assistance in problem determination through a 
uniform mechanism for reporting and diagnosing software 
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Failures. DOS/VSE contains facilities that collect problen 
data resulting from errors detected within the Supervisor, 
subsystems or user programs. This problem data is recorded 
on a DASD file. 


The following line items make up the facilities provided by 
VSE/IPCS : 


- Problem Dump Data Collection and Management 
- Creation of a problem description report by extracting 
specific keyword problen symptom information from the 
dump. This 1S especially intended to support the customer 
in evaluating whether he has a user proplem or IBM 
problem, in the light of the new Service terms and 
conditions announced with DCS/VSE and related software. 
It should also lead to much faster resolution of software 
problems, by producing clear, sufficient and concise 
problem related information. 
- Problem Dump Data Display 
- Special Formatting otf DOS/VSE and VSE/POWER control 
blocks 
- ASSistance with APAR reporting 
- Bibliography : SC34-2015 User's Guide and Reference 
GC34-2016 Program Summary 
GC34-2017 General Information 
LY¥25-0004 Logic 
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The following 1ist of programs are some of those licensed 
programs that are officially supported by DOS/VSE. There are 
Other licensed programs that wiil also run, but these will 
have to be reviewed individually. Finally, this list also 
includes some FDP's, LUP's etc., but again this list is far 
from exhaustive, Again, please refer to your own FSC 
locations oc System Marketing Centres for Support statements 
on products NOT mentioned here. | 
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a ee Re pan ee Ee ee BE Ca ay Boe SO Sy ee eee SPOS Oe ee ne TR ee EG ee Ce Ge ee 
| PROGRAM #] PROGRAM NAME | FBM | AVAIL. | 
ere (ee ee re re rer ee ee a Naa [rere 
| l ] | 
| MISCELLANEOUS PROGRASS ] | | 
| l | | 
| S746-AM2 | VSE/VSAM | yes 1 6/79 | 
|} D7460-XE3 | VSE/POWER with RJE Feature ] yes } o/79 |] 
|} 5746-SU1 J] IBM Systems 1401/1440/1460 Emulator] yes } 6/79 | 
1 5747-CC3 | 1401/1440/1460 §& 1410/7010 | 1 6/79 | 
| { obDOS/VS IR Emulators for S$/370 | | | 
|} 5746-AM3 | VSE/IBM SYSTEM/3-3340 DATA IMPORT | yes | 6/79 | 
| 5735-CV1 | RPG II S/3 Conv. Preprocessor a } 6/79 | 
{ 5746-TS1 | VSE/ICCF { yes 1 6/79 | 
|} 5747-CC1 | IBM 3800 Printing Subsystem IR | yes { 6/779 | 
| 5746-SA1 | VSE/Interactive Probler | yes 1 6/79 | 
| | Control System (VSE/IPCS) | | [ 
|} S7460-UT3 | VSE/Data Interfile Transfer, ij yes 1 6/779 | 
| { Testing and Operations | | | 
| | Utility (VSE/DITTO) | | 
} 5746-RCY |] DOS/SVSE Remote Entry | yes } o/79 | 
| } Workstation i | | 
1 D27460-AMD | VSE/3270 Bysinc Pass Through | yes 1 3/80 | 
{1 5748-MS1 | Interactive Productivity | yes } 6/79 | 
|} Facility i 1 
|} S746-XE6 | IBM Systemn/370 and IBN ] yes |} 5/780 | 
| |} 4300 Processor ] | | 
i | Job Entry Program | | | 
1 5748-XE6 | File Transfer Program | yes 1 5/80 | 
| i | | 
| LANGUAGES/SSORTS/UTILITIES | ] | 
| | | 
| 5746-R2G1 | DOS/VS RPG II | yes 1 6/79 | 
| 59746-CB1 | vbos/VS Coboi and Library {| yes } 6/79 | 
|} S74bB-LMY |] DOS/VS COBOL Library {| YES | 6/7/39 | 
| 5730-PL3 | bOS PL/I Optimizer and Library | yes J} 6/79 | 
} 5730-PL1 | bOS PL/I Optimizing Compiler } yes | 6/79 | 
1 57360-LM4 | DOS PL/I Resident Library | yes 1 6/79 | 
| 5736-LMN5 | bOS PL/I Transient Library ij yes i 6/79 | 
|} 57460-LM3 | vOS Fortran IV Library Option 1 i} 12/79 1 os79 | 
{1 5746-SM2 | DBOS/VS Sort/Merge V2 | yes ] 6/79 | 
| 5748-XX1 |] VS Basic | yes 1 6/779 | 
|} S748-AP1 | VS APL } yes 1 6/79 | 
| | { | 
| DB/DC PROGRAMS | | | 
| i i | 
|} 5740-XX1 |] DL/I BDOS/VS | yes | 6/79 | 
| 5746-XXC | DB/DC Data Gictionary { yes j 6/719 | 
1 S5740-XX7 j| DL/I Entry | yes } 6/79 | 
| 5746-XX3 |] CICS DOS/VS | yes ] 6/719 | 
ER ee aie een ae Sant ae Ne erie earn aS AEE eS AE PC A Re ee Oe ALN CEL ee CN eM Ee ek eee Rn eee J 
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ee ne ce ee cn te fe SS re en ee ee ee ee oe ae eee eer ay 
| PROGRAK #] PROGRAM NAME j FSM ] AVAIL. | 
deface rege eres Sa eres ee ee ee ee ee oe calor, aac cies aa eae es | 
| | 
TELE-COMMUNICATION PROGRAMS | | | 
| | | 
5735-XX6 | Network Communication | yes | 7/80 | 
{ Control Facility | | | 
5735-XX3 ] SSP for ACF/NCP/VS | yes | 6/79 | 
5735-XKxX2 | NOSP | yes | 6/719 | 
5735-XX7 |] Network Terminal Option | yes | 9/79 | 
5735-XX¥8 | Network Problem | yes | 7/80 | 
| Determination Application | | | 
9736-RC3 j VIDEO/370 | J} 6/779 | 
5746-RCO3 | <ACF/SVTAM Release 2 | yes | o/s79 | 
5746-RC7 | AcCF/VTAME | yes |] 8/779 | 
5735-XX1 | ACF/SNCP/VS | yes }] 6/79 | 
S7T47-AI2 | NCP 5 i 1 6/79 | 
5747-AG1 | EP 3 | } 6/79 | 
5746-RC5 | BLAM-ES | yes ] 6/79 | 
S747-CC6 | Subsystem Support Services | yes | 6/79 | 
5747-BJ2 | Subsystem Program Preparation | yes } 6/79 | 
| Support (SPPS [) | | | 
5747-B3I3 j 3650 RSS Host Support | yes | 6/79 | 
5747-BK1 j 3660 Supermarket Host Support, BSC j yes | 6/779 | 
S747-BK2 [| 3660 Supermarket Host Support, SDLC| yes | 6/779 | 
5735-D16 {| 3650 Subsystem Program Preparation | yes | 6/779 | 
{| Support (SPPS IT) i / | 
5747-C3J2 | Programmable Host Support i yes | 6/79 | 
5746-BR1 } 3600 Host Support | ] 6/79 | 
5746-CJ1 | 3630 Host Services i 1 6/79 ] 
5747-BQ1 | 3790 Host Support i yes | 6/79 | 
5S747-BW1 | Batch Transfer Program i } os779 | 
Ws i gl ssp sa sb ic Me i Sas i Sei a i a a a ai a a ia a Nad a aie ae SS eet ad 
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pe ee ey a a ee paps ee ee gre ye te oe wee ee One gl ee tee Cee g gare Ne et ee eg Oe Be TR eh Se Eee eg ny ee ee 
| PROGRAM #] PROGRAM NAME | Fou j AVAIL. | 
aaa aaa as a a ee ata oe ert gee ge Cia, Ss (a eras 
| | | | 
| APPLICATION PROGRAMSNS ] | { 
| | | | 
|} 5735-E91 | EPIC Socrates | yes |] 6/79 | 
| 5735-E93 | EPIC Budget/Finance | yes | o6/79 | 
| 5736-N13 | CFO II { 1 6/79 | 
| 57360-N14 |{ ALPHA Search II | yes |] o6/79 | 
| S7460-AM1 |] Interactive Personnel Systen | yes J] 6/79 | 
{ D7465-F11 ] PC/3600-DO0S/VS | | 6/79 | 
] 574&6-F12 |] DOSCHECK | | 6/79 | 
1 5746-N11 [| Life Inquiry/Data Entry | yes | 6/779 | 
1 S746-XC2 | DMS DOS/SVYS Vi i yes j 6/79 | 
1 S746-XM2 | MPSX/370 DOS/SVS j yes | 6/79 | 
| 5746-XP1 |] PROJACS 1 1} 6/79 | 
| 5746-XX2 ] STEPS 1 6/79 | 
| 5746-XR4 | STAIRS DOS/YS | yes | 11/79 | 
| 5746-XXA | PLANCODE/S DOS/VS | yes | 6/79 | 
| 5746-XxXG | ATMS II DOS/SVS | j 6/79 | 
| 5746-XXM | CORMES yes } 6/79 | 
1 S5746-XKP | Online Routing | yes | 6/79 | 
| 5746-XXQ | Data Base Design Aids V2 DOS/YS 1 6/79 | 
} 5S746-XX9 | PLANCODE/I DOS/YVS | yes | 6/79 | 
1 5746-XXS | Customer Information Facility/VS i | 6/79 | 
| } (CICS DOS/VS) i | | 
|} 5748-H11 |] HCS-Electrocadiagram Analysis II | | 6/79 |] 
|} S5748-xXC2 | ONS/3790 i yes } 6/79 | 
1 5748-¥C3 | DMS/3770 i yes ] 6/79 | 
{| 5788-XX3 | Chained File To DL/I Bridge | yes | 6/79 | 
| 5748-XX6 | Interactive [Instructional System V2| yes |] 6/779 | 
| S748-XXE | Document Library Facility | yes {| 6/779 | 
|} 5748-xXx9 | Document Composition Facility | yes ] 6/79 | 
| S7Y5-AAG | FERST/VS - Message Switching | { oy79 | 
| S795-AAT | FERST/SVS - Equipment Control | |] 6/79 | 
] S7I5-AAL | FERST/VS - Freight Billing | | 6/79 | 
| S795-AAN | FERST/VS - Rating/Rate Audit | 1 6/779 | 
1 5746-M41 4] CAPOSS-E | 3/80] 6/79 | 
| S746-F52 } IFS 1 ] j 10/79 | 
1 5746-F53 | IFS 2 i } 10/779 | 
Maha i a essen Aka nace a a a ae pee | 
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1. 6/79 is defined as the date of general availability 
of DOS/VSE 
2. Be aware that the programming support for 5747-CC3 
has been discontinued from this time. 
3. The following programs ate pre-requisites for 5746-LM3 
~ FORTRAN IV Compiler (360N-F0-479) 
~ FORTRAN Library (360-LM-480) 
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With the advent of a major hardware announcement and 
accompanying LOS/VSE announcement, many new names and 
machine numbers have been introduced. What follows 1S a 
glossary of all those hew names/numbers that are used in 
this Guide, alony with a brief description to what they 
refer. 


ee Se RE ee, he ee ag EN ye Oe Mey Oe RS gg ee Pe ny ee ee eee ee ee ee me | 
| MACHINE #| DESCRIPTION OF HARDWARE | AVAILABLE |] 
ee a ia ss Og et ee ee piesa Pe Seley ey ae eg aaa | 
| | I { 
| 3262-1 | Printer,attaches nativeiy to | 77/80 | 
] | 4331/4341 | | 
|} 3289-4 } Printer,attaches natively to | 6/79 j 
| 1 4331/4341 j i 
} 3310 | FBM DASD,attaches to 4331 | 6/79 ] 
1} 3370 |] FBM DASD,attaches to 4331/4341 | Note | 
{| 3880 | DASG control unit,attaches to 1 8/79 | 
i } 4341 block MPX | | 
|} 4331 | Processor,.5M or 1M storage options| 6/79 | 
} 4341 | Processor,2M or 4M Storage options | 2/80 | 
|} 8809 |] Tape unit,attaches to 4331 | 6/79 ] 
Mr cae cc a a a a a a a ee 
NOT 


For 3370 attachment to DASD Adapter on 4331, FCS is 20/80 
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js ae a a a a ech a creme nte e 
| ABBREVIATION] FULL MEANING of AEBREVIATION | 
1 ame ee sen te seem cam see sane seme came cea ets te | ne ee ene cc see sn, seme me weno seme seme ase ee ee 


VSE/AF R2 


| J i 
| /370 mode {| /370 Compatibility Mode | 
| AMS | VSAM Access Method Services Proglam | 
| BAM | Basic Access Method Component of DOS/SVSE ] 
} CA |} VSAM Control Area | 
{| CEC ] Central Electronic Complex or CPU | 
|} cr | VSAM Control Interval | 
| CKD | Count Key Data; referring to conventional DASD | 
j DA } Direct Access | 
| DAM | Darect Access Method | 
| £-mode | ECPS:VSE Mode | 
| FBS | Fixed Block Mode; specifically 3310,3370 devices] 
| ICA {| Communications Adapter on the 4331 | 
| ICR ij Independent Component Release | 
| IR | Independent Release l 
i rts }] Indexed Sequential | 
| ISAS | Indexed Sequential Access Method | 
| SAM 1 Sequential Access Method i 
| VSAM | Virtual Storage access Method ] 
|] VSE | Virtual Storage Extended | 
| YVSE/AF R1 i VSE/Advanced Functions Release 1 | 
| | VSE/Advanced Functions Release 2 | 
| l | 
| i | 
L 
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Yhe purpose of this Section is to Suma@arise the available 
hardware publications that have been produced to support the 
announcement, installation and operation of the 4300 
processors. Note that the software publications for the 
individual licensed programs addressed in this Guide, are 
contained in the relevant chapterysection that discusses 
that progran. 
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| FORM # | DESCRIPTION OF PUELICATION | AVAILABLE| 
ie er aaa ORS 5 ech eee a ea ee ee gee ey aad ane 
i / | 
| IBM 4331 PROCESSOR RELATED MANUALS | | 
| | | | 
| GC20-xxxx] 4300 Processors Bibliography | FCS | 
| GA22-7000] System/370 Principles of Operation {| CURRENT | 
} GA33-1523|] IBM 4300 Processors Summary | ANN | 
| j and I/O and Data j | 
| | Communications Configurator | | | 
} GA33-1524] IBM 4331 Communications }] ANN+2mths| 
| | Adapter Configurator | | 
} GA32-00394{ IBM Input/Output Device Summary | ANN | 
|} GA27-3185] IBM Data Communications Device | ANN | 
| ] Summary | | 
|} GA24-3667j, IBM 4300 Processors I[InStailation } ANN | 
| | Manual-Physical Planniny | | 
1 GA27-3006|] Remote Multiplexors and ] ANN | 
| ]} Communication Terminais Installation |] | 
| ] Manual -Physical Planning | | 
| GA22-7070] IBM 4300 Principles of Operation { FCS | 
| | For ECPS:VYSE mode | | 
|] GA33-1525] 4331 Operating Procedures | FCS | 
| ] and Problem Determination Guide | i 
} GA33-1526] IBM 4331 Functional Characterist. | ANN+2mths] 
| |] and Processor Complex | | | 
| {| Configurator | | 
J GA33-1527j, IBM 4331 Channel Characteristics } FCS | 
| GA33-1528] IBM 4331 Compatibility features | ANN | 
1} GC22-7064|] IBM I/O Equipment Installation ] ANN | 
| | Manual-Physical Planning | | 
| | For Systen/300, System/370, | | 
| } and 4300 Processors j | 
{| GX24-3670] 4300 Processors Channel | FCS | 
i | Worksheet | { 
} GX¥28-3725|] 4331 Processor Complex ] ANN | 
{ and ] Installation Manual - | | 
{| GX24-3728|j Physical Planning Template | | 
} G-57579 | =$44331 Processor Template |] ANN | 
i j (adhesive) ; | 
1} G-57578 | 4331 Processor Template | AWN | 
| j (non-adhesive) | | 
Oct a a a a i a a a Sai ee ol emi din ea alia gta Sain ls na 
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a a a a a aaa aa a a a | 
| FORM # | DESCRIPTION OF PUBLICATION ] AVAILABLE] 
Por ire e  a S ee e rtr eae een eE ieee la ceae aera a | 
| | i 
| IBM 4341 PROCESSOR RELATED MANUALS | | 
| | | 
] GA24-3672] 4341 Functional Characteristics and | ANN | 
i {| Processor Complex Configurator i i 
{1 GA24-3671} 4341 Channel Characteristics 1 4/79 | 
| GX¥24-3666] 4341 Processor Complex | ANN | 
|} Instailation Manual-Physical Planning] { 
| | Template (1:48 scale) | | 
| GX24-3729|] 4341 Processor Conplex | ANN | 
| | Installation Manual-Physical Planning| | 
{ j; Template (1:50 scale) | | 
| GA2Z4-3669] 4341 Operating Procedures } FCS | 
| {j and Problem Determination Guide | | 
{ GA33-1523] 4300 Processors Summary and | ANN | 
i { Input/Output and Data Communications | } 
| {} Equipment Configurator i j 
| GC22-7064] Input/Output Equipment Installation | ANN | 
i | Manual - Physical Planning for i ] 
| | Systemn/360, System/370 and | | 
| J} 4300 Processors | l 
{| GN22-2159}] TNL to above, for 3278-2A { ANN | 
| GN24&-3667]| 4300 Processor Complex Installation |] ANN | 
{ | Manual-Physical Planning ) | 
} GA22-7070] 4300 Processors Principles of } FCS 4331 | 
| {| Operation of ECPS:VSE Mode | j 
} GA32-0039] Input/Output Device Summary } ANN | 
| GA27-3185] Data Communacatons Device | AYN | 
| |} Summary | | 
| GX¥24-3670] 4300 Processors Channel Load { FCS | 
| } Summary Worksheet | | 
Oa a a a es a a a I a a a rm 
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|] AVAILABLE} 


| FORM # {| 


Z2¥11-6070j 
i 
SK 10-6240 | 


i 
GK 10-6253] 
GK 10-6243] 
GK 10-6246] 
GK10-6247] 


DESCRIPTION OF PUBLICATION 


4300 Processors Product 
Excellence Foil Set 

4347 Processor Brochure ‘How 

do I gain with the 4341 Processor' 
4300 Processor Overview Brochure 
4341 Processor 

3370 DASD 

3880 Storage Control Facility 


| | 
4300 MARKETING SUPPORT MATERIAL INC. PROPOSAL INSERTS 


3/79 
ANN 


ANN 
ANN 
ANN 
ANN 


| 
| 
| 
| 
| 
| 
| 
l 
| 
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CHAPTERS 4 THRU 7 


(Refer to Volume [ for Chapters 4 to 7 inclusive) 
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This Installation Guide is intended for System Engineers who 
are proposing and installing DL/I DOS/VS. This guide covers 
functions specifically introduced with Version 1.5 of DL/I 
DOS/SVS. However, some of the more important points of 
features made available in Releases of DL/I LDOS/VS will be 
included (i.e. Program Isolation (PI), Multiple Partition 
Support (MPS), Checkpoint and Intersystems Communication 
(ISC) aS appropriate in the discussion). 


Note that if not otherwise explicitly stated within the 
text, DOS and corresponding DOS/VSE components are the Same. 


Section 1 gives a brief overview of the product, (i.e. 
Functions and Highlights, Hardware and Software supported, 
Summary of Version 1.5 Announcement Details etc.). 


Section 2 discusses each new Version 1.5 enhancements in 
detail. 


Section 3 gives guidance on installation and migration 
activities. 


Section 4 is intended to draw attention to some aspects for 
consideration in the area of programming and operating of 
the new version. 


Further, this Chapter contains contributions from a number 
of other System Engineers. Consequently, WTSC Boeblingen 
wishes to thank the following people, whose input into 
various sections of the Guide, was yreatly appreciated: 


DL/I Development Group, Endicott 
Juhani Ellae, Finnland 

Keith Jones, UK 

Etienne Tenmerman, Balgium 
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Del. DEFINITION OF THE PROVDUCT 


EMO AGL CATE ELD CRED LANES AER GRE. WEED eon SMD ES —e eae SIE ED CRD EI GTPY ESD 


r ‘CREMEIDD STEED ARBGREY ESET CATING STOOD SIS ERTIES CLIO NATED ARI OI EOE RE ARI OTLEY CED AAD NM TED RRS REMEDIES eA ne en ey eee ee er ee ee ae eee ee eee — rer gee ye oe 


| VERSION | 1.4 | 1.5 | 
}-------------------------}--------------}-------------+4 
| PRODUCT IDENTITY {| DL/I DOS/VS | DL/I DOSYVS | 


}-------------------------}------------—-}-------------+4 


}] PRODUCT NUMBER | 5746—-X% 1 } 5746-—xXx1 | 


CSI cacREI NORE OCIS CEMENT RAMNEESN sim ET SAND ACRES AER AAI CHEERY OER SERINE SOUR. ED CONE PROTEIN TONED RST SE CORED RETR 4+— CSUR LEEEEID SEEEENED GLEE INI ELI AED: CLL ARP ARETE AEE CTE ROT. AAASEED | CCRC SELEERD. ASRS AOR AENEID CIRO RENEIED CERRY ESAS EEN AOE. Cat ETD 


| ANNOUNCEMENT DATE } JOLY 31,1978 | JAN 30,1979 | 


| PID AVAILABILITY DATE | NOV 24,1978 ] JULY 1979 | 


}~------------------------4--------------4------------- 


| SPL STATUS ] DESIGNATED | DESIGNATED | 


}-------------------------}--------------4--------------+4 


} PRE INSTALLATION TEST } 60 DAYS 1 ©0 DAYS | 


}-------------------------}--------------}--------------+4 


| SERVICE CLASSIFICATION | A ] A | 


~------------------ == + --f- == 2p 


|] SERVICE CURRENCY } DEC 31,1979 |] | 


ae eee ee eae see ere eee 


| ANNOUNCEMENT LETTER NR. | ZP78-0748 | 2P79-06019 | 
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DL/I DOS/VS is a data base management system developed to 
improve the user's ability to implement data base processing 
applications. It provides data organisation methods that 
help to create. interrelate, and maintain large common data 
baseS Similar to those on large systems. ODL/I vosyVS 
executes as an application program in avirtual storage 
environment under DOS/VYS and DOS/VSE. 


DL/I DOS/VS has been designed to permit the concurrent 
scheduling of multiple prograns requesting DL/I DOS/YS 
services, thereby allowing access by more than one user to 
the same or different data bases at the Same time. Applica- 
tion programs may utilise this design concept in conjunction 
with CICS/DOS/VS to access DL/I DOS/VS data bases in an 
oniine or batch environment. 


Application programs call upon the data base management 
services through DL/I DOS/VS. In turn DL/I DOS/VS provides 
the application program with a level of interface to the 
data base management Services which iS independent of 
storage media programming considerations. Through installa- 
tion management tools provided by BDL/I DOS/VS, storage media 
characteristics may be changed without affecting application 
programs. Installation management can optimise productivity 
for the total community of applications and users without 
affecting the functional capabilities of any of the members 
of that community. Existing DL/I DOS/VS application programs 
can be insensitive to the reorganisation of stored data, the 
addition of new applications or data, Changes in access 
methods, organisation, or access Strategy, and the introduc- 
tion of new storaye devices. 


Using DL/I DOS/VS utilities supplied with the system, the 
aser describes the structure of the data base fron two 
viewpoints: the stored data structure as Seen by the systea, 
and the logical data structure as seen by the application. 
Only one description of the stored data exists. However, 
multiple logical descriptions may exist. These data base 
descriptions are external to application programs. They 
exist as physical tables and are referred to by the systen 
when it iS processing au access request for application 
programs. | 


Data base descriptions define symbolic names for data items 
(fields), Segments, and data bases. Within a single data 
base, the system description defines a hierarchical rela- 
tionship among Segments of the stored data structure. It 
also contains information about organisation, access strate- 
JY, the physical attributes of the data (length, format, 
etc), the physical structure of the stored data Segments, 
and storaye device characteristics. 
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fo accesS or twaintain stored data, the application program 
issues a CALL for data baSe management Services. AS part of 
the functional request, the application program supplies 
symbolic names which identify the data (Segment type) to be 
processed. Through data base descriptions, the systen 
relates the application-Supplied logical data names to 
corresponding stored data names, and performs the requested 
function against the stored data. | 


Data may be stored in one of 6 different hierarchical 
Organisations (SHSAM, SHISAM, HSAM, HISAM, HDAM, HIDAM). The 
use of HD {HDAM or HIDAM) is normally recommended where 
performance iS critical. For HS (Hierarchical Sequential) 
organised data, the access method and basic processing 
strategy may be seyguential or indexed sequential. For HD 
(Hierarchical Direct) organised data, it may be direct or 
iandexed direct. 


ReorganiSation, recovery and backup of stored data bases is 
Supported by a set of ODL/I DOS/VYS utilities supplied with 
the system. | 


The data management services are provided by VSAM for data 
bases of the HD organisation and indexed sequential data 
bases of the HS organisation. 


Highlights 


OE ARE 


Application programs may process data bases independent of 
its physical organisation or storage device used. 


Most DL/I bOS/VS main line modules are re-entrant and may 
reside in the BOS/VS Shared Virtual Area (SVA). 


Data base buffer management capabilities retain frequently 
requested data records in main Storaye, resulting in fewer 
I/O accesses for these records. 


Users may write application programs in COBOL/VS, PL/I, 
RPG-II, or ASSEMBLER language. 


Data base recovery is facilitated through the use of data 
base activity logging. 


Application programs usiny CICS/BOS/VS may issue DL/I DOS/VS 
calls to process DL/I DOS/YS data bases. 


Data base inteyrity and security 1S provided through the 
concept of sensitivity: a description of a proyram's intend- 
ed access to a data base. | 


Scheduling of multiple CICS-DL/I application programs for 
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concurrent execution is based on their sensitivity. 


More than one CICS-DL/I application program can be served by 
DL/I DOS/SVS at the Same time. 


HD-organised data bases may be defined such that logical 
relationships are established between segments of different 
hierarchical structures Stored within the same or different 
data bases. 


Secondary indexing provides indexed access to root or 
dependent seyments within an HD-organised data baSe. Any 
field or fieid combination within most Segments of a data 
base may be indexed. 


segments ot HD-organised data bases may be aefined as 
variable in length to accomodate variable length informa- 
tion. 


Segment and field exits are provided for HD-oryganised data 
bases which allow e.g. user written encode/decode routines 
to improve utilisation of direct access storage Space or to 
strenythen security of stored confidential data. 


Path calls, such aS path retrieval calls, which may Simplify 
data base calls are available for ail data base organisa- 
tions. 


Generation and support of low-level codes with continuity 
checking are functions provided in application support 
programs for the manufacturing industry oriented user. These 
ace techniques that permit the user to specify hierarchical 
ijevels within a data structure and to ensure that a struc- 
ture is not dependent upon itseli. Althoug primarily 
provided foc manufacturing industry applications, they can 
also be utilised in other environments, 


In an on-line environment, the Shared Log option eliminates 
the need for separate tape drives to be assigned to 
CICS/DOS/VS System Log and DL/I DOS/YVS Log, by optionally 
directing all DL/I DOS/VS log information to the CICS/DOS/VS 
tape/disk journal. 


Through optional parameters, the tuning facility allows DL/I 
DOS/Y¥S to be adapted to specific environments and/or appli- 
cation characteristics. Tne tuning facility provides flexi- 
ble control mechanisms for buffer and main storage alloca- 
tion. 


Multiple Partition Support (MPS) enables multiple applica- 
tion programs executing in different partitions to access 
the same data base at the Same time. For example, one or 
more oniine applications can retrieve information from a 
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data base while a batch program updates the Same data base. 
MPS, following DL/I conventions, uses DL/I resources and the 
multitasking facilities of DL/I and CICS/VS. (CICS/DOS/YVS, 
therefore, 15 a prerequisite for running MPS). 


Reload Restart enables the user to restart the reloading of 
an HD-organised data base that failed before completion. 
The data base can be reloaded without rerunniny the entire 
job by resubmitting the job with an additional JCL statement 
identifying the job as a restart of the Reload Utility. The 
system operator needs only to supply a checkpoint identifi- 
cation number obtained from a console meSSayge as the restart 
point. A checkpoint record is located approximately every 
5000 segments. 


USers may reserve Free Space in the HD organised data bases 
at load or reload time so as to reduce instances of exten- 
Sive processing during Space management Search, and also to 
reduce access time for retrieving related Segments. 


Module identifiers and a system log print utility is provid- 
ed to enhance serviceability. 


Support is provided for multiple logs on a Single tape, as 
well as a multiple volume log file. 


Unload sequence checking 1S provided. 


Disk logging is an option to allow the disk only user to 
take advantage of data integrity features of DL/I DOS/VS. 
These featureS are primarily Backout, Recovery and Change 
Accumulation. | 


The trace routine includes a short fora. 


DL/I application programs can access a data base that is 
resident in another CPU, using the CiIcsyboOS/VS Intersysten 
Communication (ISC) Support. 


A PL/I user may uSe the PL/I diagnostic information to 
‘debug’ an error condition, before the error is returned to 
DL/I DOS/VS. 


A processing option (PROCCPT=0) Supported on the PCB state- 
ment provides a performance improvement by inhibiting any 
locking (enqgueueing) by the Program [Isolation function 
during retrieve of the sate segment type in a data base. 


An enhancement notifies an MPS batch task if another task 15s 
Waiting for a resource that is owned by the MPS batch task. 
This information can be used by the application programmer 
to determine when to take checkpoints to free resources. 
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Under CMS, batch DL/I application programs can be coded, 
compiled and tested to load, retrieve and update data bases. 
Additionally, DL/I control blocks may be generated. 


Field Level Sensitivity jyives the user the ability to have 


different views of a physical seyment on an application 
basis. 
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STORAGE: 


DASD; 


TAPES 


UR: 
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4300 Systems 
/3719 115-158 


30371 


912K Realistic for /370 
1024 K realistic for 4300 Systems 


3310, 3370 
2314, 2319 


Any DOS 


Any DOS 


3330-1, 3330-2 and 3333-1 


3340-35 and 3340-70 (with/without RPS) 
As 3340-70 | 
Native, 3330-1 or 3330-11 Comp.Mode 


Supported device. 

Use fast device for logging. 

Actually there is no prereguisite for 
tape drives to run DL/I BOS/VS, as 
logging can be made to DASD. 


Supported device. 


Minimum of 120 print positions 
are required. 
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DL/I DOS/VS Version 1.5 will run on DOS/VSE and current 
DOS/VS release. VSE/Advanced Functions Rel 1 1S required. 


CICS/DOsS/VS Rel. 1.4 ais reguired for execution of ODL/I 
DOS/VS 1.5 


RPG-II Rel. 2.0 or Subsequent release is required if DL/I 
DOS/VS application programs are to be written in RPG-II. 
RPG-II Rel. 3.0 1S required if an FBM device is used. 


NOTE: Do not unload your data base under ODL/I DOS/SYS 
Version 1.3 and reload under Version 1.4 or 1.5. 
Changes made to DL/I DOSYVYS Version 1.4 now incorpo- 
rated in Version 1.5 will not allow Prefix Resolution 
to function properly if any data base contains 
logical relationships or secondary indices. If you 
are currently still oon Version 1.3 then install 
Version 1.5, unload your data kases under this 
version and destroy Saves made under version 1.3 or 
previous after reload test. 


Te ENS Mae ae TE A RE KR A EE TEES GRD stMk> <a esc 


fDEPENDENCY ITEM] REMARKS | 


|+-—-—-——--—-—-~—-——-—-———}-—-—-—_ -—- + --—_ +--+ ----—--- + Sec i a a a a ca ns ca as ——— 


|CLCS/DOS/SVS | Required for online programming, 

J | Multiple Partition Support and for | 
| | Intersystems Communication. | 
|SORT/MERGE } Required for DL/I Change Accumulation | 
| ] Utality and for Pretix Resolution Utility | 
ja a a a 
| ASSEMBLER | Required by DL/I DOS/VYS | 
J|COBOL/SYS {| Customer dependent | | 
| PL/I |} Customer dependent i 
| RPG-II | Customer dependent (Rel. 2.0 or Subsequent) | 
{DMS/VS DOS/VS | Customer dependent | 
JDMS/CICS/VS DOS/VS and DOS/SVSE Customer dependent i 
iGIS DOS/Y¥S ] Cannot pe used (unmodified) with MPS. | 
Na a ras ee es FoR Se nO eT Ee nN ee eT ee Be I See eR a a a nm aren 
1 VSE/VSAM | Mandatory for FBA and DL/I DOS/VS 
1VSAM | Mandatory for DL/I DOS/VS (without FBA) | 
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G510- 0740 
ZZ19-6250 
GE19-5214 


GE19-5284 


GH20- 1246 


SH24-5001 
SH12-5413 
SH12-54171 


SK24-5103 
SH12-5412 
SX24-5104 
SH12-5414 


SH24-5002 


LY12-5016 


LYBO- 0839 
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Sales Flyer 


DB/DC DOS Marketing Guide 


DL/I DOCS/VS Foil Presentation 


Adding DL/I to CICS Presentation 
General Information Manual 


Guide For New Users 
System and Application Design Guide 
Application Programming Ref. Manual 


Application Projramming Ref. Card 
Utalities and Guide for System Progr. 
system Programming Reference Card 
Messages and Codes 


Diagnostic Guide 


Program Logic Manual 


Program Logic Manual (microfiche) 
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Field Level Sensitivity 
fhe user may see only portions of a Segment, rather that the 
entire segment. 


Today's restriction of only one logical relationship per 
hierarchicai path 1S removed. The user can now define as 
many logical relationships as he needs to satisfy his 
requirements. 


4300 Systems Support 
DL/I DOS/YYS 1.5 will run on 4300 Systems, either in /370 
mode or in ECPS:VSE-mode,. 


FBS Support 

FBM Support will allow data bases and utility work files to 
reside on Fixed Block Mode devices (like 3310, 3370). This 
item 1S an inclusion of the DL/I DOS/VS 1.4 ICR FBM support. 


Unigue Segment Support 
The ability to specify that only one occurrence of a Segment 
type is allowed for that parent. 


All Partition MPS Support 


All Partition MPS Support allows one at a time operation of 
DL/I MPS tasks from an ICCF pseudo-partition. 


Extended Showcat 
The extended SHOWCAT function is used to find the high 
allocated RBA of a VSAM dataset. This function was hard 
coded by DL/I and will now be included and Shipped in 
VSE/VSAM. However, DL/I DOS/VS Version 1.5 will function on 
DOS/VS Rel. 34 too. (Refer to detailed discussion of this 
modification). 


CHS Support 

Batch DL/I programs, written in ASSEMBLER, COBOL or PL/I Can 
be created, executed and debuyged using CMS and the interac- 
tive facilities of VM/370. 


IPCS Dump Hook Support provides a mechanism for obtaining 
standardised IPCS-format dumps instead of current DLy/I dumps 
ona DL/I initiated abnormal termination of an application 
program. 
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This feature gives the user the ability to have different 
views of a (physical or logical) segment on an application 
basis. Field sensitivity enhances the DL/I DOS/VS applica- 
tion program independence from DL/I physical data structures 
and allows a finer degree of data security for data stored 
in a DL/I DOS/VS data base. 


In DL/I DOS/VS versions earlier than 1.5, the user had to 
execute the following steps in order to add fields to an 
existing segment type: 


” Unload the affected data base. This was required because 
the phySical structure of the data base is being 
changed - a Segment Size is being increaSed in size. If 
the existing data had to be preserved when the data base 
With the new Segment size is created, then the existing 
data base must first have been unloaded. 


a Modify the DBD. This was reguired to indicate the new 
Segment size. With the exception of variable length 
segments, segment SizeS were maintained in the DBD/DMB, 
not in the data base itself. 


° Rebuild the existing PSBS and DSBs affected by the 
Change. ThisS was reguired because information from the 
DBD must be physically incorporated into the DMB used by 
DL/I at execution time so DL/I can properly access the 
data base. 


* Modify all application programs sensitive to the segment 
containing the new field. This is required because the 
segment 15 increasing in size and the [/O0 area used to 
return the segment ona DL/I call must be larye enough 
to accommodate the segment. This step can often be 
avoided if the application programs are written uSing an 
T/O area larger than the Segment. If the new field is 
not added at the end of the segment however, the appli- 
cation programs! field mapping of the segment aust be 
modified to reflect the presence of the new field. This 
step is required even if the program haS no requirements 
to access the new field. 
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» Reload the data base. ThisS was required because the data 
base must be created with segments the same length as 
reflected in the DBD/OMB. 


* If logical relationships of Secondary indexing is 
present in the data base, then the logical reiationships 
must be resolved and new secondary indexes created. 


These steps are time consuming and create unnecessary 
application program maintenance. Typically the physical 
unload and reload of the data base will take several hours. 


With the availability of DL/I DOS/VS Version 1.5, the user 
is able to declare the fields ina Segment to which a 
particluar application program needs access. Therefore, if 
new fields are added to a segment, existing application 
programs will only have to be modified if they require 
access to the new fields. Typically, few existing applica- 
tion programs will need access to the new fields and thus 
program Maintenance for non-application reasons will be 
reduced over that required before Version 1.5. 


In the DL/I DOS/VS versions prior to 1.5, an application 
program iS sensitive to a segment type. It can access all 
fields within that Segment type. Security, privacy and legal 
reguirements are going to force users to control access to 
field level type information. With the current product, the 
user can only accomplish this by storing those fields in 
separate segment types. at best this technique 1S awkward 
and often is infeasible because: : 


» DL/I is limited to 255 segment types and often data base 
records contain more than 255 fieids. 


* Application programs normally tequire access to related 
fields simultaneously. Storing each field in a Separate 
Segment would require the application program to issue a 
separate call for each field. This would significantly 
increase programming effort and degrade the performance 
of the application progran. 


» Logical relationships and Secondary index uSage may 
force the user to store several fields in the same 
Segment type despite security or privacy needs. 


Now with Version 1.5 of DL/I DOS/VS the user can declare the 
access privileyes of a program to fields ina segment and 
the security, privacy and legal requirements can more easily 
be met. 
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The basic support of Field Level Sensitivity contains the 
following features: 


1. Automatic Definition Sequencing 

2. Automatic Segment Size Caiculation 
3. No Sequence Field Order Restriction 
4G. SENFLD Macro 


5. Subfields 


ES wae oriieet Chae CEE OR NE AEN ee ‘EDS GED ER er Cee ee CES Ci? ED oe SEED aia AY A CAD SR ate 


Automatic Definition Sequencing iS invoked by omitting the 
START parameter of the FIELD macro. With this feature, the 
user can avoid having to specify starting positions for 
fields that have to start at the end of the previously 
defined field. This feature is added to the physical field 
definition facility (FIELD macro) and will be present in the 
PCB view field definition facility (SENFLD and VIRFLD 
macro). For an example refer to the next page. 


AUTOMATIC SEGMENT SIZE CALCULATION 


Automatic Segment Size Calculation is invoked by omitting 
the BYTES Parameter of the SEGM macro. This feature allows 
the user to have DL/I DOS/VS calculate the size of a segment 
based on the locations and lengths of the fields identified 
as belonging to it. This feature is added to the physical 
segment definition facility (SEGM macro). However, be aware 
that DL/I DOS/VS will not be able to verify 1£ the field(s) 
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match the intended segment Size. 


EXAMPLE: 


a wae wae Eee a ~<a 


SEGN NAME=EXAMPLE,...2..2-- 
FIELD NAME=ABC,BYTES=6,TYPE=C 
FIELD NAME=BCD,BYTES=7,TYPE=2 


generates: 


} aBC | BCD | 
a 


Start of Segment "'EXAMPLE'. Seyment length 1s 
calculated to be 13 Bytes. 


Ee ae Ee OTE Sint SD TEE ea AE AIA A A ED OD EE ORE Ot ED UR Ve i RED ERED ee 


Sequence fields need no longer be the first field statement, 
allowiny the user to define his fields in the order in which 
they appear in his segment. 


SENFLD HACRO 


The SENFLD Macro allows a user to specify those fields from 
the physical definition to be included in his view of the 
segment, including their location in the new view. OCDL/I 
DOS/VS will automatically map the fields fron the physical 
segment into the applications view. 


The user identifies the fields to which he wishes to be 
sensitive at PSB generation time via a newW SENFLD statement 
following the SENSEG statement for the segment. (if no 
SENFLD statements are specified, sensitivity to the entire 
segment iS assumed). Up to 255 fields within a segment and 
4095 fields within a PSB may be specified. 
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The SENFLD Macro Format iS an external macro used to specify 
sensitive fields within a sensitive segment. SENFLD state- 
ments are optional. 


" 
i 
| SENFLD NAME=fldname{ ,BYTES=n]P ][ ,START=Position]j[ ,TYPE=t ]| 
| [ ,{ OPT J=REPL ] | 
| {OPTION} NOREPL ] | 
| 

| 


L RA ORLA CORRE CREE CARLES CONLERT COEUEUD “AEAELITN SAEED SURED ARID UTES NOCENADS SOU ND ACR AAS AAD SOT STONED AERIS EOD <TEEOED SACURIED -OELEEAY SELES PEUPEAD POLARS ERATURE GGT CUNUNUD RAIS OANIIY OAT. ANCE” MARAE IY OUTED CORLL RELI: CHONDA “COCORID SCORE MSUDURY: CGREIEEY ERAELLS- ALND: WEEE NY NOUTODSY LA OE ENED SOD AORN SS SOPRA 


NAME = fidname ‘fidname' corresponds to the name of the 
related field in the physical definition. 


BYTES = n[P 'n' specifies the length of this field in 
terms of bytes. This must be a numeric 
value in the range 1 through 256. 


‘Pp' must be specified if the length of 
the field in the application program's 
view of the field is to be the Same asS in 
the physical view. (Length derived fron 
the DBD). 


Note: Do not specify the TYPE parameter 
when you Specify BYTES=P. 


fhe '"BYTES' parameter must not be speci- 
fied for field types, E, D, or L, and 
must be specified for types X, BP, C, or 
Z. (If omitted for types H or F, values 
of 2 and 4 respectively will be assumed). 


START = position ‘position! specifies the starting posi- 
tion of this field in terms of bytes 
relative to the beginning of the user's 
view of the segment within which this 
field is defined. it must be numeric and 
in the range 1 through 32767. If omitted, 
the field will be appended to the previ- 
ous field, or, at the beginning of the 
Segment if there is no previous field. 


Subfieids are permitted. [If a subfield 
Starts in the same poSition aS a previ- 
ously defined field, the uSer may specify 
the name of the previously defined field, 
instead of a numeric value, to indicate 
the starting position (START=fieldname). 
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TYPE = t ‘t!' specifies the type of data that is to 
be contained in the application program's 
view of this field. If you specify a data 
type that is different from that defined 
in the physical DBD for this field, DL/I 
DOS/VS will (in most cases) convert the 
data type to that needed by the progran. 
(Refer to ‘fAutomatic Data Conversion’ 
later in this Chapter for additional 
information). If you do not specify this 
parameter, DL/I DOS/VS assumes the type 
to be the same aS specified for this 
field in the physical DBD. If you speci- 
fied *BYTES=P', for this field, do not 
specify the 'TYPE=" parameter. The valid 
data types are; 

'x' - hexadecinal data (binary) 
'H' - half word binary 
'F' - full word binary 


'p' - packed decimal 
'c’ - character data 
*Z* - numeric character data 


'E' - £loating point (short) 

'D' - floating point (long) 

'L' - floating point (extended) 
If omitted, the type will be assumed to 
be the same aS in the physical view. If 
'BYTES=P* was specified, the TYPE parame- 
ter must be omitted. 


{ {OPT }=REPL j 
{OPTION} NOREPL] indicates whether the program using this 
PSB may replace this field. *REPL' is the 
default value! 


EXAMPLES 


SENFLD NAME=ABC,BYTES=P 


This statement defines sensitivity toa field named ABC. 
The applications view of the field is the same as the 
physical format. The field is located immediately following 
the previous field in the applications view. The program is 
allowed to replace this field. 


SENFLD NAME=BCD,8YTES=8,TYPE=P,OPT=NOREPL 
This statement defines sensitivity to a field named BCD. The 
application view of the field 1s a 8 byte packed decimal 


field located immediately following the previous field in 
the applications view. The program is not allowed to 
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replace this field. 


SUBFIELDS 
It might become necessary to divide a field into subfields 
(1.e. as redefining data structures in application 
projrams). | 


2 


] MM | DD {| YY | 


© eine die eas 


DA <---—-—---—----—----—> Field for Date 

MM <————> Subfield for Month 
DD <----> Subfield for Day 
YY <——-——> Subfield for Year 


Defining Subfields in DL/I DOS/YVYS is meaningful only if 
these subfields are going to be used by SSAS. The 
'subfields' the program requires are defined in the HLL data 
description. 


You can reorder subfields in your application view if they 
acre not subfields of a seyguence field. 


Rules on Subfields 
1. If you define one subfield in a field, then ‘the field 
has to be defined entirely by subfields (no holes). 


2. If you have two fields that overlap, the overlapping 
area has to be entirely defined by subfield (s). 


3. If a field is a subfield of another field in the physi- 
Cal view and both fields appear in the application view, 
then it must be a subfield in the application view too. 


W. It a field is a subfield of another field in the appli- 


cation view and both fields appear in the physical view 
it must be a subfield in the physical view. 
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Ex AMPLE: NOTES 
DBE NAME=..e- 
DATASET DD1=. 2.20 
SEG NAME=. cee 
SEGK NAME=DATE,BYTES=6, PARENT=..... (1) 
FIELD NAME=MM,BYTES=2,START=1,TYPE=C (2) 
FIELD NAME=DD,BYTES=2,START=3, TYPE=C (2) 
FIELD NAME=YY,BYTES=2,START=5,TYPE=C (2) 
FIELD NAME=DA,BYTES=0,START=1 (3) 
SEGRE NAME=ETCH ,BYTES=15, PARENT=... (1) 
FIELD WNAME=DEPT,BYTES=7,START=1,TYPE=C (2) 
FIELD NAME=EMP,BYTES=5, START=8,TYPE=C (2) 
FIELD NANE=SAL,BYTES=3, START=13,TYPE=C (2) 
FIELD NAME=FLD1,BYTES=12,START=1 
FIELD NAME=FLD2,BYTES=8, START=EMP 
DBDGEN 
FINISH 
END 
PCB TYPE=DB yee 
SENSEG NAME=..-. 
SENSEG NAME=DATE,.... 
SENFLD NAME=DA,BYTES=P,START=1 (4) (2) 
SENFLD WNAME=MNM,BYTES=2,START=DA 
SENFLD NAME=DD,BYTES=2,START=3 (2) 
SENFLD NAME=YY,BYTES=2,START=5 (2) 
SENSEG NAME... 
PSBGEN ®@2 02 @3 @ 8 
END 
PCB TYPE=DB,.2<-e 
SENSEG NAME=..ec-<e-0 
SENSEG NAME=ETCH,...... 
SENFLD NANE=FLD1,BYTES=12, START=1 (2) 
SENFLD NAME=DEPT,BYTES=7,START=1 
SENFLD NAME=FLD2,BYTES=8, START=8 (2) 
SENFLD NAME=EMP,BYTES=5, START=FLD2 
SENFLD NAME=SAL,BYTES=3 
SENSEG NABSE=..-<+s 
PSBGEN s&s 9 828 2 @ 
END 
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(1) 


(2) 


(3) 


(4) 


8.2 


If you omit the BYTES-Parameter, the segment size would 
be automatically calculated from the information 
Supplied by the Field Statements. 


You may omit the START parameter as DL/I would calculate 
this value by default. 


If you omit the START parameter in this field statement, 
DL/I DOS/VS will issue an error message when you have 
coded the BYTES parameter in the SEGM statement. In case 
you did omit the BYTES parameter in the SEGM statement, 
DL/I DOS/VS would not issue an error messajye bat the 
segment would be 12 bytes long. (i.e. MM,DD,YY,DA). 


BYTES=P means the field length and data type will be the 
Same in the application view as defined in the DsD. 


IBM Internal Use wTSC BOE 


2210-9826 DOS/SVSE PLANNING GUIDE Chapter 8. 
Volume If DL/I DOS/SVS Rel. 1. 


EXTENDED SUPPORT 
In addition to the basic support, the following aitems are 
also supported under Field Level Sensitivity: 


1. User Field Exit Routine: This jJives the ability to 
Specify a routine to get control whenever a field is 
retrieved or stored. 


2. Virtual Fields: This gives the ability to identify a 
field in the application's view of a segment that doesn't 
exist in the physical view. 


3. Automatic Data Format Conversion: This gives. the ability 
to change the format of the physical data without re-con- 
piling the application programs. 


4. Dynamic Segment Expansion: This facility gives the 
ability to add fields to a segment without reloading the 
data base or re-compiling the application programs. 
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During PSB generation 
given control 
name must be 
the DOS Core Imaye Library. 


Within this exit routine, the user 
tion facility; or 


data conversions. 


INTEREFA 


Upon entry, register 15 will contain 


the uSer may 
whenever a field 
the name by which the 


he might use this facility to 


is referenced. 


GUIDE ZZ10-9826 


routine to be 
The routine 
1s cataloged in 


specify a 


routine 


can have hiS own encrip- 
do his own 


a pointer to the entry 


point, register 14 will contain the return address, register 


13 contains 


a pointer 


to a 


Standard format 


register Save 


area, and register 1 points to a parameter list as follows: 


NAHE 


FERPEC 
FER PGET 
FERPPUT 
FERPFNCT 
FERPRET 
FERPINS 
FERPREP 
FERPCSC 
FERPCSOK 
FER POSNT 
FERPCSCT 
FERPCSFE 
FERPCSTC 


FERPDSA 


FERPPFL 
FERPPFA 
FERPUSA 


FERPUFL 
FERPUFA 
FERPFSBA 
FERPUWA 


8.22 


DISP 


0 


LENGTH 


1 


had 


CONTENTS 


G 
I 
R 


(3lank) 


Cl to 
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DESCRIPTION 


Entry Code 
Get 
Put 
Function Code 
Retrieve 
Insert 
Replace 
Conversion Status Code 
CK 
Numeric Truncation Error 
Char. Truncation Error 
Format Error 
Type Conflict 


Reserved 


Physical Seyment Address 
(If variable length, points 
to a two Eyte length Field) 
Reserved 

Physical Pield Length 
Physical Field Address 
User Segment Adaress 
Reserved 

Usec Field Length 

User Field Address 

FSB Address 

User Work Area 
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The user exit routines will be entered for GET calis after 
the field has been moved (and converted if necessary) from 
the phySical segment to the application program. 


On a PUT, the routine will be entered after the field has 
been moved (and converted) to the physical view. 


SEGMENT ADDRESSABILITY 

The addresses of both the physical segment and the user's 
view of the Segment are provided to the user's routine. AS 
the field processing order 1S arbitrary, the routine should 
not rely on other fields in the user's view during GET 
processing or fieids in tne physical view during PUT proces- 
Sing. 


If any problems arise during the system supplied field 
conversion, the conversion status code will indicate the 
problem. If the user routine corrects the problem, the code 
Should be reset to a blank. Setting the code non-blank will 
likewise result in termination of the request with a status 
code of 'Cx' where 'x' is the code set by the user routine. 


A user exit routine for fields that are used in SSAS must 
not be dependent upon an other field in either view. This is 
because the routine will be called during processing of the 
SSA too and at that time there iS no physical nor applica- 
tion view available. 


The SENFLD Macro format is as follows, if the User Field 
Exit Routine is be used: 


sc ac a a es aad a tcl acl etd an alate nn eee eel ae 

| 
] SENFLD NAME=fidname[ ,BYTES=n|P][,START=position j{ ,type=t j] 
| [ RTINAME=prog ][ ,{ OPT }=REPL j | 
| {OPTION} NOREPL] | 
| | 
Ia a a ac a a a a i a a a get i ee lr ce J 
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RTNAME=prog 'prog*' is the name of a phase in the DOS Core 
Image Library that is to be given control 
whenever this field is retrieved or stored. 


EXAMPLE 


“> GAN UN A AD AN TD KO a a ee ene 


SENPLD WNAME=X,START=9,TYPE=H, RTNAME=AULIT 


This SENFLD statement defines sensitivity to a field named 
X. The user's view of the field 1s a 2 byte binary field 
located in the 9th and 10th bytes of the uSersS view. Routine 
‘AUDIT’ will be called wherever the field iS retrieved or 
Stored. The Field 'X' can be replaced. 
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VIRTUAL FIELDS 


Virtual Field statements are used to define fields in an 
application view of a segment that do not exist in the 
physical view. iL2es Fields may be identified in a 
application's view of a segment that do not exist in the 
physical segment via the VIRFLD statement during PSB genera- 
tion. 


When an application needs access to accumulated information 
for totals it might be better to use the exit routine to 
accumulate the information and pass it to the application in 
a VIRFLD. The integrity of detailed information is then 
maintained. | 


You can use the VIRFLD macro to regroup the content of a 
segment defined by SENFLD macros. You can not splat up a 
field defined by a SENFLD macro by uSing VIRFLD saacros 
alone. 


VIRFLD statements are optional. If specified, they must, 
along with any SENFLD statements, immediately follow the 
SENSEG statement for this segment. There must be one VIRFLD 
Statement for each virtual field you want included in your 
application view of the segment. 


An initial value and/or the name of a user written routine 
to be called to create the field may be specified. 


If both an initial value and an exit routine are specified, 
the value will be put in the user's view of the field before 
the routine 1S called during a GET procedure for the field. 


If a routine is specified, it will be entered both on GETS 
and on PUTS involving the field. For GETs, the user exit 
routine will be entered after the field has been initial- 
ised. If no initial value for the field is specified it will 
be initialised with the 'null' value. (i.e. For numeric 
fields: Zeroes; for character fields: Blanks. The format of 
the zeroes correspond to the 'type' specification; packed, 
zoned, binary). On a PUT, the entry to the exit routine 
Occurs immediately aS no conversion is attempted. 
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| 
{ ,VALUE=value[ ,RTNANE=prog ]} 
{ RINAME=prog ; 


| 
| 
J 


NAME = fldname indicate the name of the field. 


i 


BYTES n Indicates the length of this virtual field 
in bytes. It must be numeric and in the 
range of 1 through 256. This parameter must 
be specified for field types XxX, ©, @ and P. 
It must not be specified for E, Dor L 
field types. It is optional for field types 
H and F. 


position position! specifies the starting position 
of this field in terms of bytes relative to 
the beginning of the application program's 
view of the segment for which this field is 
defined. Start position for the first byte 
of the segment is 1; the maximum specifica- 
tion is 32767. 


START 


Subfields are permitted. If a subfield 
Starts in the same position aS a previously 
defined field, you may specify the name of 
the previously defined fieid, instead of a 
numeric value, to indicate the starting 
position (START=fieldname). 


TYPE = t 't' indicates the type of field as follows 


hexadecimal data (binary) 
half word binary 

full word binary 

packed decimal 

character data 

numeric character data 
floating point (short) 
floating point (iong) 
floating point (extended) 


roan Os wom HM 


TYPE must be specified if the VALUE parame- 
ter 185 used. 


8.26 4 IBM Internal Use WISC BOE 


2210-9826 DOS/SVSE PLANNING GUIDE Chapter 8.0 
Volume IT DL/I DOS/VS Rel. 1.5 


VALUE = value specifies an initial value for the field. 


If the RTNAME parameter iS used also, the © 


field is iunitialised before the routine is 
called. 


RTNAME = prog ‘proy' 1S the name of a phaSe in the DOS 
core image library that is to be given 
control whenever this field is returned or 
stored. 


EXAM PLES 


VIRFLD NAME=FLD1,TYPE=X, BYTES=8, VALUE=40 
This VIRFLD statement defines a field named ‘'FLD1' of 8 
bytes length, initialised as XL8'40', and starting immedi- 
ately after the preceding field. 

VIRFLD NANE=FLD2,START=4, TYPE=H, VALUE=100 
Above statement defines a field named ‘'FLD2' starting at 
byte 4 of the users view. The field 1s a half word field 
initialised to H'100'. 

VIRFLD WNAME=FLD3,TYPE=P,VALUE=0, RINAME=ROUT, BYTES=4 
This VIRFLD statement defines a four byte packed decimal 


field initialised to PL4'O'. Program ROUT will be given 
control each time the field 15 returned or stored. 
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AUTOMATIC DATA FORMAT CONVERSION 


New Data Types 

fhe following new data types are allowed on the field 
definition statements at physical (LBD-FIELD) and logical 
(PSB-SENFLD, VIRFLD) definition times: 


- zoned decimal 

~ halfword binary 
fullword binary 

~ floating point single 

- floating point double 

~ floating point extended 


Mom oN 
i 


Supported Conversions 
The following conversions are supported: 


From To 
x H,F,P or 2@ 
H X,F,P or @ 
E X,H,P or @ 
P X,H,F or @ 
z X,H,F or P 
Cc Cc 


Conversion iS not supported for field types E, bor IL, as 
there are no instructions available. Only length conversion 
1S Supported for C types. 


Conversion from one type to another will only be done if the 
field does not have subfields in either view. 


Value Restrictions 

* Binary (X,H,F) Restrictions 
The maximum nhumber containable ina four byte binary 
word iS 2147483047 and the minimum 18S -2147483648. 
Packed decimal or zoned decimal fields to be converted 
to binary are therefore restricted to be within this 
range. 


& Packed Decimal and Zoned Decimal Restrictions 
The hardware instructions for conversion limits the size 
of the zoned decimal field to 16 characters. If conver- 
Sion is needed, values must therefore be in the range + 
9999999999999999. 
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Length Conversions 

Numeric field types (X,H,F,P,Z) will be padded on the left 
with zeroes. Truncation will also occur from the left. 
Truncation of any Significant digits will result in the 
field being set to the maximum (or minimum if negative) 
value and a Status code of ‘'CA*. 


For binary fields the maximum is X*'7FFF---* and the mininuon 
X*8000----', For zoned or Packed Decimal, + $99---. 


Character fields will be padded on the right with blanks. 
fruncation will result in dropping the rightmost characters. 
Truncation of non-blank characters will result in the ‘'CB* 
Status code being passed back. Character field length 
conversion is done only if both ‘tot and ‘'from* fields are 
type cf. 


Zoned and Packed Decimal fields will be pre-scanned to 
insure valid format prior to conversion. An invalid format 
Will result in the null value being provided for the 
converted field and a status code of 'cc', 


Non-supported field conversions (i.e. Physical type ‘'Z', 
user's view "E') will not be allowed during ACB generation 
unless a field exit routine has been specified. A non-sup- 
ported field conversion will result ina 'CD' status code 
When encountered during field access. 


'c' type fields are ‘as is' representation and as such, no 
conversion will take place if the field is Leing moved into 
a different type of field. For instance, if a field is 
defined in the physical seyment as 'C' type and in a user's 
view as 'P', the field wiil be assumed to be packed decimal 
in the physical view and any length adjustment would be done 
accordingly. 


An uncorrected status code (not reset by a uSer exit rout- 


ine) wiil result in immediate termination of the request. No 
more fields or seyments will be processed. 
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DYNAMIC SEGMENT EXPANSION 
The ability to dynamically add fields to a Segment without 
re-compiliny other applications that access the segment and 
Without unloading and reloading the data base is supported 
in the following manner: 


1. When tne application's view of a segment is defined 
during PSB generation, the fields the application 
program iS sensitive to within the Segment must all be 
defined via SENFLD or VIRFLD statements. 


2. The physical segment is defined as variable length with 
the maximum and minimum lenyths both set to the data 
length plus 2 for the length field. 


Programs that have specified fields to which they have 
Sensitivity will always view the segment as fixed 
length. The two byte length field will be maintained by 
DL/I DOS/VS. The user will only see it if he has specif- 
ically identified it as a field he iS Sensitive to. 


3. If a field has to be added to the Segment, it is defined 
in the physical segment definition after the last 
currently existing field. The maximum and minimum length 
parameters are increased to include the field. ACB 
Generation has to be executed. 


4. When a variable length segment 18 used with Sensitive 
fields, it will be expanded or truncated to fit the 
user's view. (Expansion will be by adding null values 
for defined fields or binary zeroes for undefined 
areas). 


Note that this technique cannot be used for segments intend- 


ed to be source segments for secondary indexing. (1.e. Index 
Source segments cannot be variable length Segments). 
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The functional capabilities of DL/I DOS/VYS Version 1.5 are 
improved by removing some restrictions in the area of 


. Logical Relations 
° Definition of PCBs. 


The user gains more flexibility in constructing logical data 
bases compared with earlier versions of DL/I DOS/VS. 


However, the user of these new capabilities has to consider 
the impact on performance and recovery/restart when design- 
ing his data base, 


LOGICAL DATABASES 

The restriction that only one logical relationship can be 
utilised in one hierarchical path of a logicai database 
(1.@. e@ach hierarchical path of a logical database may 
contain only one concatenated Segment) has been dropped. 
(For an example refer to LDB2 Segment B/A and E/M). 


This allows repetition of a logical relationship down a 
nierarchical path (e.g. in descriping product structures) or 
to relate three or more segments from different physical 
databases in one hierarchical path (e.g. Customer -> Insu- 
rance -> Accident). 


Application programs can now mote often deal with one Single 
PCB and will less frequently require the need to maintain a 
synchronised position in different PCBs. 


The restriction that the relative sequence of Segments from 
left to right on any hierarchical level in a logical data 
base must correspond to the relative sequence of the corres- 
ponding segment in their physical databases has been dropped 
except for dependents of a logical Lrelationship (For an 
example refer to LDB1, Segment L, M, N and S). 


The cule for logicai children is changed to: In its physical 
data base, a logical child seyment cannot have another 
logical child as its immediate dependant. (For an example 
refer to PDE1 Segment B and &£). 
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Rules for defining logical data bases are expanded in the 
following way: The physical parents of the destination 
parent and their dependents up to the root of the physical 
data base in inverted hierarchy can be included as depen- 
dents of the concatenated segment. (For an example refer to 
LDB2 Segment L and N). 
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The rule that the SENSEG statement in the PCE must appear in 
the Same pierarchical Sequence as in the DBD has _ been 
Changed. For HiDAM and HIDAM data bases, segments on the Same 
jevel need no longer be defined in the Same Sequence as in 
the DBD except if the PCB specifies an alternate sequence 
and except if the segments are dependents of a concatenated 
segment. However it 15 recommended that the required 
hierarchical structure is defined in a logical DBD rather 
than a PCB wherever possible. 
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There are no changes necessary to DL/I DOS/VS to support the 
4300 Systems. All support is through DOS/VSE 
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8.2.4 FBM SUPPORT 
The FBM support is actually made available through an ICR 
for DL/I DOS/VS Version 1.4. 


FBM support in DL/I DOS/VS is deSigned to allow the DL/I 
DOS/VS data bases and/or log file to reside onan FBS 
device. The major difference between FBM and count-key-data 
(CKD) devices 1S the addressing scheme. FBM is laid out as a 
series of blocks, which are presently 512 bytes long, 
Starting at zero and numbered Sequentially to the capacity 
of the device. It is addressed by block number rather than 
the familiar CKD disk address. The concept of tracks and 
cylinders no longer exists in addressing an FBM device, as 
it iS looked at aS a contiguous series of physical records. 
VSAM and SAM are the two access methods that Support FBM 
devices. Functions impacted by FEM are: 


* DBDGEN 
° space Management 


* Utilities 


The DBDGEN macros will be changed to accept FBA aS a device 
type. It also makes no sense to specify the number of 
cylinders to scan for space any longer. This will be changed 
to scan a certain number of blocks if the device specified 
is FBA. Because device characteristics are not known at 
DBDGEN time and are intended to be transparent to the user, 
device sensitive parameters such aS track capacity, number 
of control intervals per track and number of control inter- 
vals per cylinder are not set at this time. 


External changes to DEDGEN are confined to the DATASET macro 
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parameters which will be changed as follows: 
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The device parameter specification of 'FEA* wiil indicate 
that the database is to be placed on an FEM device. It will 
also cause other DBDGEN macros to avoid device sensitive 
code. 


If FBA 1S specified in the DATASET macro onthe DEVICE 
Statement, the number specified in the SCAN parameter will 
no longer be the delta cyiinders to be scanned when looking 
for space; but will represent the number of physicai FB*S 
blocks to be scanned. A default for FBM will be generated 
the first time that Space management 1S entered for each 
data base, that is eguivalent to three cylinders on a 
count-key-data device. If specified, this number may be any 
integer fron 0 to 32767 blocks . The default for a CKEL 
device 15 still three cylinders. The following macros will 
be impacted by this support: 


DATASET 
DBDGEN 
DLZDBGLB 
DLZDBVSI 


* ¢€ @ 6 
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SPACE MANAGEMENT 

Space Management contains routines that are device sensitive 
to improve the performance.It is desirable to keep this 
philosophy, which scans for space by tracks and cylinders, 
for FEM-sSupport. To accomplish this, Space management will 
issue the DOS/VSE GETVCE macro the first time it is entered 
for each data base to obtain the device characteristics. The 
device characteristics will then be used to calculate the 
number cf control intervals per track and cylinder to be 
inserted into the DMB for space management's use. Secondly, 
the number of phySical FBM bliocks to be scanned will ke 
rounded up to a cylinder boundary. This is done to insure 
Naxinmum efficiency in the scan routine and to eliminate 
changes to this routine. 


UTILITIES 


The utility support of FEM will be done by changing the 
DLZ2DVCE and the DLZDTPRM macros. These macros will be 
Changed to accept FBA aS a device type and also recognise 
the FBM device code of X'90' in the PUB. When an FBM device 
is encountered DLZDVCE wiil do the Same as it does for 3350 
and 3330 mod-11, and insert only the file name and logical 
unit into the DTF. All other changes to the DIF will be nade 
at OPEN time by DOS/VSE. 


INVOCATION 


eenRine Cnet Ane eatin AE ARNT - sree weed SORES what 


The ASSGN, DLBL, and EXTENT statements must be supplied as 
always. A difference does arise when defining space for 
VSAM, and when generating DBD's for DL/I DOS/VS. For DBDGEN 
the DATASET statement BDEVICE= parameter must specify FBA, 
and the SCAN= parameter indicates te physical number of 
FREM-Blocks to be scanned instead of cylinders. 
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ERROR MESSAGES 

The Same errors already known for DBD Generations Cah occur 
with FBM as well. If the user Specifies DEVICE=FBA but in 
fact the data base resides on a count-key-data device, Space 
Management will issue message DLZ831I and abend the job. The 
user must then insure that the data base 15 on a FBM device, 
or rerun the DBD-generation with the correct DEVICE= parame- 
ter. 


wrSC BOE IBM Internal Use 8.39 


Chapter 8.0 DOS/VSE PLANNING GUIDE ZZ10-9826 
DL/I DOS/VS Rel. 1.5 Volume II | 


A new parameter will be supported for the POINTER operand on 
the SEGM statement in the DBD - NOTWIN - which will specify 
that only a single occurrence of this segment type will be 
allowed for a parent. | 


SEGM NAME=Seg-namel 
[ ,PARENT=.cncece |} 


2 82: ens 8 8 } 
{ ,POINTER={ NOTWIN } ] 
{ 2 82 e828 @ @ } 
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NOTWIN saves 4& bytes in the prefix of the segment being 
defined and Some processing activity at load time. 


The condition of the specification 18S passed from DBDGEN to 
the action modules aS a bit in the PSDB (Physical Segment 
Description Block). Retrieve, while processing position for 
insert, wili insure that no other occurrence of the segment 
occurs under the Same parent. 


ERROR MESSAGE 
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The existence of another segment under the Same parent at 
the Same time will result in an ‘'II' status code returned 
for insert or ‘iB! for load returned to the program in 
response to an insert or ‘load’ call. 
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All-Partition MPS Support removes a restriction from current 
DL/I DOS/VS Multi Partition Support (MPS) to allow 
ohe-at-a-time operation of DL/I MPS tasks from VSE/ICCF 
pseudo-partitions. During MPS initialisation, a set of 
XECBS will be defined for every partition inthe systen 
(including the online CICS/DOS/VS partition itself). 


No chanyes to the method of invoking MPS support nor changes 
of error messages are made. 


Note however, that the TWASIZE specified in the DFHPCT for 
the DLZMPCOU Program has to be increased to 268 Bytes. 
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The extended SHOWCAT function is used to find the high 
allocated RBA of a VSAM dataset. This function is used in 
DL/I DOS/VS presently by hard coding the macro expansion of 
the VSAM CATALOG macro. This had to be done since DL/I 
DOS/VS ships source code to the user, but VSAM does not Ship 
the CATALOG macro. To avoid this code dependency in the 
future, the SHOWCAT macro, which iS shipped with VSAM, was 
extended to include this function. | | 


The code for this item is in the Space Management nodule 
(DLZGGSP0) and in the OPEN/CLOSE module (DLZDLOCO). 


To find the high allocated RBA of the DL/I DOS/VS data base 
the SHOWCAT Macro is coded as follows: | 


SHOWCAT CI=addr,AREA=addr, EXTCOPT=HARBADS 


CI= specifies the address of the 
Work area for the number of the 
First CI of the catalog entry. 


AREA= specifies the address of the 
work area used to return the 
high RBA. 


EXTOPT=HARBADS specifies that the high 
allocated RBA of the data set 
is desired. 


If an error occurs while trying to find the high allocated 
RBA, DLZGGSPO will return to the calier with k15=4. This 
indicates that the requested space was not aquired because 
something was wrony. OPEN/CLOSE will also return an error 
to the user using existing messages. _ 


To avoid DOS/VYSE Rel.1 becoming a prerequisite for DL/I 
DOS/VS version 1.5, this extended showcat macro is used for 
FBM devices only. This will be changed in later versions of 
DL/I DOS/VS. | 
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CMS libraries can be used to store DL/I macros and applica- 
tion programs. Coding and generation of DL/I control blocks 
as well as creation, modification and compilation of Appli- 
cation programs iS facilitated by the CMS text manipulation 
and EXEC facilities. Languages supported are assembler, 
Cobol, PL/I and RPG-II. 


The DL/I DOS/VS macros must reside on a CMS maclib to permit 
the use of the CMS assembler. 


Batch DL/I programs can be link-edited and executed either 
interactively or in CMS Batch. On-line DL/I programs using 
CicS functions must be submitted to a DOS machine’ for 
link-edit and execution. 


Execution under control of CMS can fetch phases from a DOS 
library. The data used for the test can be in CMS LIBS or it 
can be a DOS Data Set. Once the programs, tested under CMS, 
acre ready for production, they must be submitted to the DOS 
Machine for cataloging into the core image library. 
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IPCS Dump Hook Support provides a mechanism for obtaining 
Standardised IPCS format dumps instead of current DL/I dumps 
on a DL/I initiated abnormal termination of an application 
program. These dumps are intended to be used by the IPCS 
Service routines to assist the system user with problea 
determination. These dumps are captured on disk storage 
devices using a logical unit called SYSDMP. 


There are no direct interactions between the user and DL/I 
for this function. If the user specified the SYSDMP option 
for the DL/I partition, the dump hooks are activated. 
Otherwise, DL/I dumps are taken in the current manner. 
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following features of Field Level Sensitivity are not 


supported by IMS: 


1. 


10. 


WESC 


Field type conversion. 
Field types 4, E, DBD ox L. 
Field exit routines 
Virtual fields. 


Automatic segment length calculation for physical 
segments. 


Automatic fieid start location calculation for physical 
fields. 


Automatic field start location calculations for sensi- 
tive fields. 


‘P* parameter on SENFLD BYTES parameter for 1:1 match to 
physical fields. 


Arbitrary order for FIELD Statements for sequence 
fields. 


Coverage sensitivity sufficient for sequence fields on 


insert. IMS reyuires Sensitivity to sequence fields by 
name. 
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IMS does not Support arbitrary order of sensitive seyments 
in HDAM or HIDAM data baSes. They must be in the Same order 
aS in the physical data base definition. 


By droppiny restrictions from earlier DL/I DOS/VS releases, 
the design of a data base must be carried out very careful- 
ly. Logical data bases can be constructed by combining many 
physical data bases. Therefore, when deSigning logical 
databases (especially in the online environment) the user 
has to consider very carefully performance and 
recovery/restart procedures. 


When there are many physical data bases involved in one 
logical data base, the record level enqueveing (Program 
Isolation) per data base call and resulting segment enqueue 
after the update can become Significantly high. (All access 
paths to the inserted/deleted segments will remain engueued; 
replacement calls enqueue only the affected segment). 


Procedures for recovery/restart must be setup very careful- 
ly. If any of the physical data bases involved in a logical 
data base become damaged due to hardware or suftWare errors, 
tne user will normally have to recover and restart all 
physical databases; dependent on the data structure conplex- 
ity, database availability in case of an error can be 
degraded significantly. 
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DL/I DOS/VS programs that have run on previous releases of 
DL/I DOS/YVS will still execute properly on version 1.5. No 
reassembly will be necessary. If FSM Support is desired, 
the m@eaniny of the 'SCAN=' parameter on the DATASET state- 
ment wiil now aindicate phySical FEM blocks. This change is 
triggered internally in the DBDGEN macros when DEVICE=FBA is 
Specified. 


If you have to move your data bases to an FBM device, the 
following Steps must be executed: 


° Unload, Image Copy or Export your data baSe{s) from 
Count-Key-Data device. 


* Regenerate the affected DBDs and run the biock builder 
to catalog them to the systen. 


° Define data base space and cluster as anew FBM file 
With the AMS DEFINE command (1.@. modify AMS Job streams 
and JCL to reflect biocks instead of tracks and cylin- 


ders). 
* Use Reload or Import to have your data base on the FBS 
device. 


Note : If you migrate from an earlier release of DL/I DOS/VYS 
than 1.4 do not use unload reload, as changes made to the 
method the Prefix Resolution Utility works, will not allow 
for successtul execution, (The Control Lata Set normally 
created by Pre-Reorg contains the sort size required by 
Prefix Resolution). 


Upward migration to [8S as incompatible since IMS does not 


currently support FBM devices. (Note that Import will need 
changes from CKD; Device=FBA). 


WTSC BOE IBM Internal USe 8.47 


Chapter 8.0 DOS/YSE PLANNING GUIDE ZZ10-9826 
DL/I DOS/VS Rel. 1.5 Volume II 


The NOTWIN parameter 1S compatible with the INS implementa- 
tion of this feature, 
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When generating a DOS/VSE Supervisor, the increased number 
of XECBS required for the MPS-Support must be taken into 
account. AS soon aS MPS is started, 2 XECBs for each parti- 
tion in the system are defined plus 2 additional ones for 
the whole system. Each active batch MPS task requires 2 
other XECBs during itS operation. So the number of XECBS 
required for MPS support is: 


2+ (2 * (N + M)) %N: Number of partitions generated 
in the Supervisor. 
M: Maximum number of concurrent 
running MPS batch programs. 
N and M can vary from 2 to 7. 


In the CICS/DOS/YS Program Control Table (DFHPCT) you must 
increase the TWASIZE to 268 Bytes due to that support. 
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The SHOWCAT Macro replaces the CATALOG Macro previously 
used. The function performed is the same; therefore, there 
iS no migration consideration. 
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VM/370 release 5 is required to run DL/I under CMS. VM/BSE 
1.1 may be used with VM/370 release 5. DL/I 1.4 or subse- 
quent versions must be used for this support. DL/I must 
first be installed to a DOS system. Once this task complet- 
ed, the DL/I macros must be copied to a CMS MACLIB for use 
by the CMS assembler. 


The anstaliation ana the maintenance of the DL/I system 
itself and the execution of the DL/I utilities are not 
Supported under CMS. These functions need to be executed in 
the DOS machine. 
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Actually MPS wasS provided in DL/I Release 1.2 and is not 
‘new’ to the 1.5 release. 


FUNCTION 

DL/I DOS/VS Multiple Partition Support (or MPS for short) is 
a facility that allows several application programs cunning 
in different partitions to access the same data bases 
concurrently with full data base integrity. 


MPS iS impiemented aS an extension to the CICS/VS - DL/I 
DOS/VS anterface and thus requires CICS/VS to operate. 
Batch DL/I programs communicate their DL/I requests to the 
CICS/VS partition via the cross partition event control 
facilities of DOS/VS. Special transactions in the CICS/VS 
partition receive these reguests, issue the appropriate DL/I 
calls and pass back the results to the batch partitions. 
All data base I/0 18S performed by the DL/I facility within 
the CICS/VS partition. MPS operation is transparent to the 
application program. Existing application programs, both 
batch and online, need not be changed when used in this 
environment. 


MPS 1S especially applicable to users who must keep data 
bases online for the major part of a day and need to be able 
to run batch reports or perform minor file updating during 
this period. Without MPS, the data bases would have to be 
closed in the online system while the batch programs were 
being run. DL/I DOS/VS is the only DOS/VS data management 
facility that provides full multiple partition support with 
complete data base integrity. 


SECURITY 

Special CICS/VS transactions are provided by DL/I which 
allow the user to dynamically enable and disable the multi- 
ple partition support facility. 


Additional security is provided via the DL/I Application 
Control Table (ACT). The ACT acts as a master list of all 
authorized programs and PSB combinations that may be used to 
access adata base. fhis facility, in conjunction with 
VSAM's share option 1, will prevent batch programs from 
accessing online data baSes except under control of MPS. | 


The DL/I PSB (Program Specification Block) provides an 
additional level of security on a program-by-proygram basis. 
The PSB allows the user to control the access rights of 
individual programs to any Segment within a. data base 
record. 
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INTEGRITY 

Hecause all data base reguests from both batch and online 
projrams are channeled to a Single facility, DL/I 1s able to 
prevent programs from attempting to update the same informa- 
tion Simultaneously. In a Similar way, DL/{I is able to 
detect deadiocks between programs and resolve then. 


In addition, DL/I provides full before and after data base 
segment image logging and a comprehenSive set of utilities 
to allow for recovery of the data base in the event of a 
software otf hardware failure. With MPS a Single log is 
written for all DL/I partitions (in the CICS/VS partition). 
If desired, CICS/VS emergency restart will invoke the DL/I 
backout utility during emergency restart processing to 
restore the DL/I data bases to a Known point where proces- 
sing may be restarted, backing out any updates made by 
programs executing at the time of failure. CICS/VS emergency 
restart provides this function for both batch MPS programs 
and online DL/I transactions. CICS/VYS Dynamic Transaction 
Backout may be used to automatically back out the changes 
made to DL/I data bases by failing batch MPS application 
projrams. 


RESTRICTIONS 

certain DL/I programs are restricted from running in the MPS 
environment, 1.e. the data bases they access may not be 
Shared across several partitions while these programs are 
executing. The programs in this category are; 


* All DL/I Utilities 
° All proyrams that access SHSAM or HSAM data bases 
° All proyrams that load data bases 


In addition any batch DL/I programs tnat modify the contents 
of the DL/I control blocks cannot run under MPS since the 
DL/I control blocks no longer exist in the batch partition. 


All data bases accessed by a program running under MPS 
control must be defined in the cCICS/VYS partition and 
accessed through MPS. A program running under MPS control 
cannot access any data bases not known to MPS, 1.2. not 
defined in the CICS/VS partition. 


DL/I MPS can be active in only one CICS/VS partition ata 


time, i.e. two concurrently executing CICS/VS partitions 
(test and production) cannot both have DL/I MPS active. 
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Actually Program Lsolation waS provided in DL/I Release 1.3 
and 15 not new to the 1.5 release. 


Program Isolation 18 an optional addition to the Segment 
intent scheduling techingue used by prior releases of DL/I 
to insure data base integrity when multiple tasks are 
concurrently accessing and modifying data bases. 


All PSBs in ODL/I, whether originally intended for batch or 
online uSage, contain indicators as to the access intent (no 
access, read-only access, update access or exclusive access) 
of each Segment in each data base described in tne PSB. 
During scheduling of the PSB, DL/I checks the segment access 
intent of the scheduling PSB against all other scheduled and 
Walting PSBs. Scheduling of PSBS for online programs occurs 
when the application program requests it via a Scheduling 
(PCB) call. Batch MPS programs are automatically scheduled 
by DL/I during their initialization phase. 


With intent scheduling, if a potential simultaneous update 
or deadlock problem couid occur, DL/I will suspend the 
program attempting to schedule until the conflicting 
programs have released their PSBs. 


With Program J[solation, with the exception of tasks that 
have requested exclusive access to a Segment type, all tasks 
are allowed to process concurrently. To provide integrity 
for the concurrent update tasks, all data base calls made by 
tasks are monitored by DL/I so it can prevent Simultaneous 
updating of the same segment occurence by muitiple tasks. 
By monitoring the DL/I calls iS also able to detect and 
resolve deadlocks between tasks due to conflicting data base 
call patterns. 


Program Isolation gets its name from the fact that all data 
base activity of an application program iS isolated form all 
other application programs active in the system. This 
concept makes it possible to dynamically back out the data 
base activities of an application program that terminates 
abnormally without affecting the integrity of the data bases 
controlled by DL/I. This backing out does not affect the 
activity of other application programs processing concur- 
rently in the system. 


The use of Progran [Isolation requires that the CICS/VS 
system include support for the dynamic transaction backout 
facility and that ali DL/I transactions be specified in the 
PCT with DIB=YES. 


Note that Program Isolation is not Supported for SHISAM. 
For HISAM data baSe processing, Program Lsolation cannot be 
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used if PROCOP?=I iS Specified on root Segments. 
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8.3.10 EXECUTING CICS/VS WITH DLZI 


There are several operational considerations when executing 
DL/I MPS or PI under CICS/VS additional to those for execut- 
ing CICS/VS with a non-MPS or PI version of DBL/I. 


With MPS you may have defined additional data bases in the 
ACT that were formerly used in batch partitions only. If 
this is so, then any ASSGN, DLBL, and EXTENT statements 
necessary for these data basesS will have to be piaced in the 
JCL stream used to execute CICS/VS. In addition the presence 
of additional data bases in the CICS/VS partition will 
increase the GETVIS freguirements of the partition. fhis is 
due to the additional VSAM control blocks and buffers needed 
to support the new data bases. Therefore it may be necessary 
to chanye the SIZE parameter on the EXEC Statement oF 
increase the virtual partition size of the CICS/VS parti- 
tion. 


With the addition of MPS to your CICS/VS systen you Should 
expect the volume of log records written ky CICS/VS-DL/I to 
increase. Therefore 1f you are logging to disk you should 
consider allocating laryer extents to the log data Sets. 


If MPS operation is started or stopped from a terminal (CSDA 
and cCSDD transactions), no messajye iS sent back to the 
terminal acknowledging the request. A message 15 sent to the 
System console indicating the success or failure of the 
Start or stop request. 


DL/I DOS/VS PI useS the partition GETVIS area to maintain 
information about segments and records that are enqueued as 
a result of a reference to them by concurrently executing 
DL/I tasks. This Space 1S acquired in 2K increments dynami- 
cally by UDL/I as required. Cnce acquired it iS never 
released. Therefore 1t may be necessary to change the SIZE 
parameter on the CICS/VS EXEC statement or to increase the 
Vittual partition size of the CICS/VS partition to provide 
additional GETYIS space in the partition. 


For PI operation the UPSI statement used with the CICS/VS 
job stream aust specify DL/I log function active (Bit 6 = Q) 
and DL/I loj assigned to the CICS/VS system journal (Bit 7 = 
0). Pi also requires the CICS/V¥S Dynamic Transaction Backout 
facility be active. If either the UPST bit settings are 
incorrect or dynamic transaction backout 18S not active in 
your cicsyVS system, DL/I support will terminate with a 
DLZO31I message. 


With Dynamic Transaction Backout and PI active be sure to 
leave enough temporary storage Space to contain the dynamic 
log records. To estimate the size of the dynamic log 
requirements for DL/I, all x'50' ODL/I log records are 
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Maintained within the dynamic log for the duration of a 
CICS/VS logical unit of work (LUW). The CICS/YS LUW for a 
batch MPS proyram is from initialization to termination of 
the program unless CHKP calls are issued by the batch MPS 
program. CHKP calls indicate the completion of a LUW to 
CICS/VS and the dynamic log records will be released at that 
point. 


CAUTION: An operator Should never ao an Immediate Shut-down 
of CICS/VS with DL/I. CICS/VS Emergency Restart may 
be required following an Immediate Shut-down of 
CICS/VS to recover the data bases. 
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8.3.11 EXECUTING BATCH MPS PROGRAMS 


In order to execute a batch MPS application program CICS/VS 
must be running in another partition and SPS operation must 
have been started (CSDA transaction). 


The batch UPSI byte settings for MPS are the Same as for non 
MPS batch execution with the exception that bits 6-7 are not 
used. Data base logying, normally controlled by UPSI bit 6, 
is controlled in the CICS/VS partition under MPS operation. 
STXIT iinkage to DL/I for abnormal task termination, normal- 
ly controlled by UPSI 7, is always active under MPS opera- 
tion. It may not be turned off aS is the case in non-MPS 
batch execution. 


No ASSGN, DLBL, EXTENT, or TLBL statements are required to 
describe the data bases or DL/I log in the batch MPS job 
Stream. This information is contained in the JCL for the 
CICS/VS partition. | 


The 'DLI' parameter information for batch MPS operation need 
only specify the program name and the PSB name. Any other 
parameter information such as buffer pool options, etc. are 
ignored as this is controlled in the CICS/VS partition. 


The phase name on the EXEC statement must be 'DLZMPIOO'. A 
SIZE parameter is not required unless your application 
program invokes some DOS/VS function that requires a parti- 
tion GETVIS area; however the use of the SIZE parameter is 
recommended as an operational standard. ODLyI MPS does not 
require a partition GETVIS area in the batch MPS partition. 


Batch MPS programs that were written to issue PCB and TERMS 
calls for DbL/I Release 1.2 will freyguire changes. With PI 
active, batch MPS programs may not issue PCE and TERM calls 
for read-only or update PSBs. If this is attempted the 
program will be abnormally terminated with a DLZ102T 
message. 
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8.3.12 DYNAMICALLY SCHEDULING MPS OR NON- 
The requirement that a different phase name must be used on 
the EXEC statement to distinguish between MPS and non MPS 
operation can cause operational difficulties. The operations 
staff must be aware of when CICS/VS 1s active and MPS in 
operation and modify the JCL of batch DL/I jobs to specify 
the appropriate phaSe name on the EXEC statement. 


An alternate approach would be to uSe a program to dynami- 
cally test to see if MPS waS in operation or not and fetch 
the corresponding phase. The program can use the XECBTAB 
TYPE=CHECK macro to test for the presence of the XECB 
TDLZXCBOO'. If this KX£CB 1s currently defined (R15=0) then 
MPS operation iS active and the program can fetch the phase 
‘DLZMPIOO'. If MPS operation iS not active (R15#0) then the 
program Should fetch the phase "DLZRRCOO'. Note that this 
technique will not work if logying 1S required as there is 
no way to dynamically assign the DLyI log device if non MPS 
operation is reguired. 


The JCL to execute a batch DL/I Program in this environment 
would use an EXEC statement that specifies the XECB testing 
program's name, not DLZMPIOO or DLZRRCOO. No other changes 
in JCL would be required. 


An example program to do this for read-only {no logging) 
DL/I programs 1S given below. | 
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DLZCTRL CSECT 


BALR R12,0 ESTABLISH BASE REG (R12) 

USING  *,R12 AND TELL ASSEMBLER 

OPEN PRINTER ,CONSOLE 

XECBTAB TYPE=CHECK, XECB=DLZXCBOO0 

LTR R15,R15 IS MPS ACTIVE? 

BZN NOMPS NO 

LA R2,=C'DLZMPIOO! YES, USE DLZMPIOO 

MVC IOAREA(L'MPSMSG) ,MPSMSG 

LA R7,L°*MPSMSG SET UP MPS ACTIVE MSG 

B OUTPUT GO WRITE MSG & FETCH DL/I 
NOMPS EQU 

LA R2,=C*DLZRRCOO® NOT ACTIVE, USE DLZRRCO00 

MVC IOAREA(L*NOMPSMSG) , NOMPSMSG 

LA —R7,L'NONPSMSG* SET UP MPS NOT ACTIVE MSG 
OUTPUT EQU * 

PUT PRINTER INDICATE CHOICE TAKEN 

PUT CONSOLE ON SYSLST AND SYSLOG 

CLOSE  PRINTER,CONSCLE 

FETCH (R2) FETCH APPROPRIATE PHASE 
MPSMSG DC C'MPS ACTIVE - WILL EXECUTE DLZMPIVO! 
NOMPSMSG DC C'MPS NOT ACTIVE - WILL EXECUTE DLZRRCOO® 
PRINTER DTFDI DEVADDR=SYSLST, [OAREA1=IOAR EAC, RECSIZE=81 
IOAREAC DS OCL81 

pc X'F.t 
IOAREA DC CL80' * 


CONSOLE ODTFCN DEVADDR=SYSLCG, IOAREA1=IOAR EA, BLKSIZE=80, 
RECSIZE= (7) ,RECFCRM=UNDEF, MODNAME=DLZCONSL 
END 
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8.3.13 JOB ACCOUNTING WITH BATCH MPS PROGRAMS 


Note that since the data base I[/70 operations are being 
carried out in the CICS/VS partition for the batch MPS job, 
the DOS/VYS job accounting information for the batch parti- 
tion will not reflect any data base I/OS or associated CPU 
time for the data base call processing. 


If the Performace Analyzer II FDP (5798-CFP) or similar 
program 1S being used to collect job accounting information 
for the CICS/¥S partition, the data base I[y0s and associated 
CPU time for the data base call processing will be charged 
to the DL/I batch partition controller task, CSDC. 


The very same consideration applies to tasks using the ISC 
Support. There all remote data base call activities will be 
Charged to the CICS/VS mirror transaction if the task is 
local or to the remote task if the task have been invoked 
iocally. 
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8.3.14 PROGRAM ISOLATION CONSIDERATIONS 


When a deadlock occurs between two or more DL/I tasks 
because of conflicting call patterns, the DL/I Program 
Isolation facility will resolve the deadlock by abnormally 
terminating one of the tasks. The task with the fewest DL/I 
records and segments engueued will be the one ABENDed. The 
only exception to this is that if an online task 1s dead- 
locked with a batch MPS program, the online task will always 
be ABENDed regardless of which has the fewest enqueues. 


Because a deadlock only occurs between tasks, and is depen- 
dent on the time Sequence of data base calls made by the 
various tasks, it 1S impossible to predict at what point in 
processing any particular program will be at when a deadlock 
ABEND occurs. The task that is ABENDed nay not be the one 
that issued the data base call causing the deadlock. 


If a batch MPS program is ABENDed, only the chanyes it made 
to the DL/I data bases will be backed out by the Cicsysvs 
Dynamic TranSaction Backout facility. Any changes the batch 
MPS program made to other batch files will not be backed out 
Since they are not under control of DL/I or cCICS/VS. It is 
your responsibility to provide a mechanism to back out any 
other chanjyes made to other batch files by the batch MPS 
program after an ABEND. (kxefer as well to chapter ‘Abnormal 
Termination, Recovery and Restart). 


Duriny the dynamic transaction backout processing, CICS/VS 
will issue messages only to CSMT for batch MPS programs. No 
message iS written to the CPU console directly. Therefore in 
the event of a batch MPS program ABEND (for any reason) you 
Will have to verify that backout was successful by examining 
COMT. 


Tf you have proyrams that should not be exposed to the 
potential of a deadlock ABEND, then you can uSe PROCOPT=E in 
the programs' PSBs to eliminate deadlock potential. Specify- 
ing PROCOPT=E on all Sensitive Segments gives the program 
exclusive control over the segments. Since no other task 
sensitive to the same segment types can be concurrently 
scheduled with tnis PSB, the program cannot become dead- 
locked on DL/I resources. 
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LL/I has the capability to write its log records on several 
different media. Only one medium can be chosen at any one 
time. Your choices ale; 


* VSAM ESDS on disk. 
° SAM data Set on Standard labeled tapes. 
* Assigned to the CICS/VS system journal. 


In a batch non-MreS enviconnent you fay use either of the 
first two choices. If tne disk log option iS chosen, you 
must define tae VSAM cluster with the 'REUSE' parameter. 


In a batch HPS environment the logging 18 performed from the 
CICS/VS partition, and no log device 1S assigned in the 
batch MPS partition, 


In a CICS/VS environment only the last two choices are 
available. However if any of the CICS/VS recovery facilities 
(Emeryency Kestart or Dynamic Transaction Eackout) are to be 
used With DL/I tasks, the DL/I log must be assigned to the 
CICS/VS system journal. This choice usually performs better 
in a CICS/VS environment. The CICS/VS systen journal is a 
SAM workfile and can reside on either disk or tape. Note 
that CICS/YS does not use standard labels on its tape 
journais uniike ovatch DL/T. The CL/I utilities, with the 
exception of the backout utility, will accept all forms of 
log input however. The DL/I pbackout utility, when executing 
in a batch partition, will not accept CICS/VS SAM disk 
journals aS anput. Any CICS/VYS journal records on the log 
input are ijnored by the DL/I utilities. 


If the DL/I log is assigned to the CIcCSyVS systen journal, 
CICS/VS assumes all responsibility for opening and closing 
the logging device and performing I/O as required. DL/I 
Still maintains its write ahead logging logic correctly when 
its log 1s assigned to the cCICS/VS journal. 
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DL/I disk logying 1S an option only in batch non MPS progran 
executions. The choice of whether to log to disk or tape is 
controlled through a parameter (LOG=...) on the DLI control 
Statement. The default 15 LOG=TAPE so that no changes are 
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reguired in operating procedures from previous releases 
(previous to DL/I 1.3) for the same log option. 


The DL/I disk log is a VSAM ESDS unlike the CcIicsy¥VS disk 
journal which is a SAM data set. Thus before using disk 
logginy you must define the disk iog ESDS in the VSAM 
catalog. The data set must be defined with the reusable and 
recovery attributes. When DL/I opens the disk log for output 
logging it specifies RST which resets the VSAM catalog high 
RBA to zero, effectively destroying any loy records current- 
ly in the data set. Therefore before you reuse a disk log 
data set for another program execution you should first take 
steps to preserve the existing log records. This could be 
done by running the DL/I change accumulation utility against 
the log data set or by copying the log records to another 
data set. 


Because the volume of log records is difficult to estimate 
accurately, there are a number of options Which may be 
specified to avoid job termination when the disk log data 
set fills up. 


1. You can define the VSAM cluster with secondary alloca- 
tion. Thus when the primary allocation fills up during 
program execution, VSAM Will automatically acquire 
additional space for the data set and allow the program 
to continue. This support is inherent in VSAM and is 
transparent to DL/I or the application program. All DL/I 
disk log data sets should normally be defined with 
secondary allocations. 


2. You can specify two log data sets (LOG=DISK2) and DL/I 
Will switch from one to the other when the log data set 
currently being used becomes full. When the switch 
occurs DL/I will close the current log data set and 
write a DLZO076A message on the CPU console. When the 
operator responds 'GO' to this message, BL/I will then 
open the other data set and write a DLZ077I nessaye. At 
this point the operator should execute a program in 
another partition to preserve the oid log data set 
contentS in case another log switch becomes necessary. 


3. If you only specify one log data Set (LOG=DISK1) then 
DL/I wiil close the data set when it becomes full and 
issue a DLZ076A message on the CPU console. At this 
point the operator must execute a job in another parti- 
tion to preserve the log data set contents. After the 
log data set contents have been copied or otherwise 
preserved, the operator can ceply ‘'sO' to the DLZO76A 
message and DL/I will reuse the log data set. If you 
Choose to operate with this option, then the asynchro- 
nous operator communication feature of the Advanced 
Functions ({DOS/VS Program Product 5746-XE2) should be 
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used to facilitate console operations. 


Through the use of the NOPAUSE specification in the LOG 
parameter it 1S possible to bypass the DLZ076A console 
message and consequent operator interaction. Only the 
DLZO77I message will be issued with this mode of operation. 
Because of the danger of losing a set of log records, 
especially when operating in the environment described above 
in point 3, you should not use the NCPAUSE specification. 


fhe performance of your application programs can be very 
dependent on the efficiency of the DL/I logging mechanism. 
You can affect the efficiency of the DL/I logging mechanisn 
in the design of your data base application. Minimizing the 
number of physical writes to the log wili improve the 
logging mechanism efficiency. Physical writes to the log are 
required whenever: 


1. The log buffer fills up. 


2. A modified data base record is about to be written back 
to disk and the log trecords corresponding to the change 
have not yet peen written. 


The second condition described is known as a ‘force write’ 
of the loy. Physical writes to the log because of the first 
condition are performed aSynchronously by BL/I. Force writes 
acre by their very nature synchronous. Thus the execution of 
your application program will be delayed until the log 
record 1S written. If your application proyram causeS many 
force writes to tne log, you will find that the performance 
of your application program is dependent on the speed of the 
logy device. Note that the effect of using the asynchronous 
logging option is to skip the force writing of the log under 
the condition described in (2) above. 


There are several things you can do in designing your data 
base applications to Minimize writing to the log; 


* Avoid the use of HISAM. The HISAM access method uses 
VSAM logical record processing. AS a consequence, DL/I 
has no control over when a physical write to the data 
base will occur. Therefore DL/I must assume every PUT 
reguest to VSAM will result in a physical write to the 
data base. This causes DL/I to force write the log more 


WISC BOE IBM Internal Use 8.65 


Chapter 8.0 


DL/TI 


You 
best 
the 
on a 
regu 
duri 


+—~ 
i 
| 
| 
l 
| 
| 
| 
I 


DOS/VSE PLANNING GUIDE 
1.5 Volume II 


ZZ210-9826 
DOS/VS Rel. 


often than would normally occur if an HD access method 
were chosen. With the HD access methods, DL/I has 
complete knowledge of when physical writes to the data 
base are actually occuring. Physical writes to the data 
base in the HD access methods tend to be deferred 
longer, thus allowing a greater opportunity for an 
asynchronous log write. 

INDEX data bases, either HIDAM primary index data bases 
or secondary index data bases are also processed using 
VSAM logical record processing. Therefore the Same 
conditions exist when DL/I updates these data bases as 
exist for HISAM data bases. Be particularly careful with 
secondary indices. Every time the souce field value 
Changes for a secondary index, DL/I will write at ieast 
three log records. If the source field is very volatile, 
considerable logging activity will occur. 


Consider the relative data 

Several HD data bases to the 
two highly active data baSes are assigned to the Same 
Subpool, activity in one data base will probably cause 
DL/I to write back updates to the other data base sooner 
than would otherwise be necessary. DL/I will do this to 


base activity when assigning 
Same HD buffer subpool. If 


free up buitfer space in the subpool. This, in turn, 
could cause force writes to the log. Balancing the 
activity across subpools, where possible, will reduce 


the occurence of this premature log I/O. 


Should attempt to use the device that will give you the 


performance for your log. The following table compares 
time required to write the default (1K) DL/I log record 
variety of IBM devices. This table assumes no seek is 
ired on disk and no channel contention is encountered 
ng the write. 7 | | 
IBM Device | Data transfer | Start-—Stop | Total log | 
Eiee | time for 1K | rotational | write time | 
| |} bytes | delay time | | 
——-——-——---———}-—----—----- --- 4 -- -- - + --- | 
3410/11-—1 | 51.2 ms | 15.0 as | 66.2 ms | 
34170/11—2 | 25.6 ms | 12.0 as | 37.6 as | 
3410/11-3 | 12.8 ms | 6.0 as | 18.8 ms | 
3420-3 | 8.5 ms | 4.0 ms | 12.5 ms | 
3420-5 | 5.1 ms i 2.9 ms | 8.0 as | 
3420-7 | 3.2 as J z-0 as | 5.2 0S | 
3330-1. | 1.3 as | 8.4 ms | 9.7 ms | 
3340/44 | 1.2 mS | 10.1 ms 4] 11.3 as | 
3350 | 3 ms | 8.4 ms | 9.3 ms |} 
3420—4 | 2.2 a5 | 2-3 m5 | 4.5 ms | 
3420-6 | 1.3 as | 1.6 as | 2.9 as | 
3420-8 | 8 as |  i.1 ms | 1.9 as | 
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AS can be seen on above table, device start-stop time 
(cotational delay for disk devices), is generally the major 
factor in the log write time. This 1S more pronounced if the 
iog records are shorter than 1K, which is often the case in 
an online environment. 
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8.3.16 DL/I CHECKPOINT (DL/I REL. 1.3) 
Since Release 1.3, DL/I provides a way for an application to 
checkpoint DL/I data baSe processing. The CHKP-call, when 
used in conjunction with other facilities provided by bDOS/VS 
will allow DL/I application programs to establish check- 
points periodically during processing. If a failure should 
occur, after recovery, processing can be restarted at the 
last checkpoint rather than at the beyinning of the program. 


With the use of the CHKP-call, DL/I application programs can 
be written that will permit faster recovery and require less 
reprocessing after a failure has occured. 


Upon restart after a failure and subsequent recovery, it is 
the application program's responsibility to resume proces- 
Sing logic at the point of the last DL/I checkpoint call. 
This may reguire the application program to reposition 
itself in other related files, restore intermediate totals 
or other control figures being maintained within the 
program, etc. DL/I provides no mechanism for this function. 
Refer to the chapter ‘Abnormal Termination Recovery and 
Restart’. | 


By 1Sssuing a CHKP (Checkpoint) call the application program 
causes BL/I to: 


1. Write any log records currently held in the log buffer 
on to the log. 


2. Write all nodified data base records currently held in 
Main storaye buffers onto the data bases. At this point 
any poSition in the data bases is lost. 


3. Write a special checkpoint record on the DBL/I log. 


4. Write a DLZ681I message on the CPU console indicating 
successful completion of the CHKP-call. 


5. Returns control to the application progran. 


Since any position in the data bases is lost at step 2, the 
application program must reposition itself in its data bases 
after executing a CHKP-call. 


Once a CHKP call is successfully executed, any data base 
Changes made by the application program up to that point are 
reflected ain the data pase on secondary storage. If a 
failure should occur Subsequent to the CHKP call, only the 
data base chanjes reflected on the data base since the last 
CHKP call need be backed out. When the DL/I packout utility 
is executed it will stop when encountes a checkpoint record 
on the log. 
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Related File Processing Considerations 

Note that changes the application program made to other 
files (ISAM, VSAM, etc.) which were still in main storage 
buffers at the time a DL/YI CHKP call is issued are not 
Written back to the files on secondary storage. It is the 
application program's responsibility to devise a means of 
insuring this information is written to those files at the 
time a DL/I CHKP call 1S issued, for example by closing the 
related files. 


After a failure occurs and DL/I backout has been fun, the 
data bases reflect all the changes made to them up to the 
last DL/I checkpoint. If other files (ISAM, VSAM, etc.) 
must logically synchronize to the DL/I data bases, then you 
must provide Some way of synchronizing them to the data 
bases. No such facility 15S provided by DLyI. 


DL/I checkpoint should only be used in a batch MPS progran 
operating in the following environment: 


° The DL/I log is assigned to the CICS/VS system journal. 


* Dynamic transaction packvut support haS been generated 
into the CICS/VS system. 


» The DL/I Batch Partition Controller transaction, CSDC, 
has 'DTB=YES' specified in its CICS/VS PPY entry. 


When a ODL/I checkpoint call 1S issued in a DL/I batch-MPS 
program under these conditions, ODL/I performs the following 
functions: 


1. Writes any altered data base records owned by the task 
that are currently in main storage buffers back to the 
data bases. This action will also force write the log 
records for these changed data base records, if neces- 
Sary. At this point any position in the data bases is 
lost. 


2e Writes a CIcS/VS synch-point record on the CICS/VS 
system journal. 
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3. Dequeues any records or segments engueued for this 
program 1f PI (Program Isolation) is being used. 


4. Writes the 'DLZ105I* message on the system console 
indicating that a DL/I checkpoint call has been success- 
fully executed. 


>. Returns control to the application progran. 


If a failure subsequently occurs, CICS/VS will invoke its 
dynamic transaction backout facility and back out all data 
base Changes made Since tne last checkpoint call was issued. 


Note that Since no DL/I checkpoint records are written to 
the CICS/VS system journal, the system journal cannot be 
used as input to the DL/I backout utility operating in 
batch. CICS/VS dynamic transaction backout 18 the only way 
the effects of failing batch MPS programs can be correctly 
backea out. | | 


AS 18 the case for non MPS batch programs you must provide 
any synchronization between the DL/I data bases and other 
related files (ISAM, VSAH#H, etc.). Restart of the batch MPS 
program has the same considerations aS non MPS batch 
programs discussed later. 


cated ere atahes CI GUD ORIEN TIENTS AND METS NUE AEE qi ec ———_ ome arm CINE seme se ete ea SUNRip ED WEED -enibe ERNE RNR CENA SIN inte iD CUNY wee 


It iS technically possibie to issue a CHKP call from an 
online DL/I transaction. If a cCHKXP-call 1S issued by an 
online transaction BDL/I performs the following functions: 


1. Writes any altered data base records owned by the task 
that are currently in Main storage buffers pack to the 
data bases. This action will also force write the log 
records for these changed data baSe records, if neces- 
Sary. At this point any position in the data bases is 
lost. | 


2. Writes a CICS/VS synch-point record on the CICS/VS 
System journal. No DL/I checkpoint record iS written on 
the CICs/VS journal. A DL/I checkpoint record iS written 
On the DL/I log only 1f ait is not assigned to the 
CICS/VS system journai. 


3. . Dequeues ali records or SegmentS enqueued for this task 
1f program isolation is being used. 


4. Returns control to the application program. 
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Because no DL/I checkpoint record 318 written to the CICS/VS 
System journal in step 2, it 18 impossible to use the 
CICS/VS system journal wath the DL/{£ backout utility ina 
batch partition. The only way to correctly back out the 
efifects of this task after a failure 185 through CICS/VS 
emergency restart. 


If instead of issuing a CHKP call, the online transaction 
issues a TERM call, then in step 2 a DL/I termination record 
will be written on the CICS/YS system journal; steps 3 and 4 
remain the same. Because of tie presence of the DL/I termi- 
Nation record on the loy, the cCICS/VS system journal can 
then be used with either CICS/VS emergency restart proces- 
Sing of with the DL/I bacxout utility in a batch partition. 


Because of the added flexibility in recovery with TERM 
Calls, CHKP calls should not be used in online transations. 
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8.3-17 ABNORMAL TERHINATION, RECOVERY AND RESTART 
Abnormal termination of a ODL/I program can occur in a 
variety of ways: 7 


* Batch DL/I Program ABEND. 
° Batch MPS program ABEND. 
* Online DL/I transaction ABEND. 


* DL/I system ABEND (anternal error). 


» CICS/VS system ABEND. 
» Power failure. 


The state of the data bases and DL/I log after each of these 
ABEND conditions is discussed below. You must have tested 
operational procedures to recover from each of these types 
of failures. 


DLZE TERM SALL AND FICS SYNC PCINT PROCESSING 
DL/I DOS/VS TERM call processing for a read-only PSB does 
NOT implicitly invoke CICS/VS Syne Point Processing. This 
leads to some application recovery guidelines: 


* When a transaction first schedules a read-only PSB and 
then later schedules an update PSB, the user must not 
assume that updated CICS resources (e.g. VSAN data sets 
etc) are synchronised by DL/I TERMination of the 
read-only PSB. Termination of the update PSB will cause 
CICS Syne Point to be taken in the normal way. 


* If the user needs to synchronise CICS resources before 
scheduling the update PSB, he should issue a CICS 
SYNCPOINT (DFHSP TYPE=USER) reguest to implicitly 
terminate the read-only PSB. 


° If there 1S no need to synchronise CICS resources, a 


DL/I TERM call Should always be used in preference to 
CICS SYNCPOINT request for performance reasons. 
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° Since a DL/I TERM call for a read-only PSB does not 
force the end of CICS Logical Unit-of-Work, the transac- 
tion remains eligible for Automatic Transaction Restart 
(CICS 1.4 only). 


BATCH DL/T PROGRAM ABEND 


In case of a failure in a batch environment of a DL/I 
program the backout utility may be run to backout DB changes 
occuring since the last checkpoint. 


For concurrently updated other files, the user has to take 
care for recovery. A possible way to do so is described 
later under ‘Restarting MPS Batch Programs’. 


The DL/I abnormal termination routine in a DL/I batch MPS 
program cannot be bypassed. In a batch MPS environment the 
DL/I abnormal termination routine performs the following 
Functions; 


1. Writes the ‘'DLZ096I' message on the system console if 
the abnormal termination was caused by a program check 
or other error that causes DOS/VS to anvoke a STXIT AB 
exit. Possible causes of a STXIT AB can be found in the 
DOS/VS Superviser and I/O Macros manual in the section 
that discusses the STXIT macro. If OCDL/I's abnormal 
termination routine was entered directly from ODL/I, 
Cather than through a STAIT, then the CLZO96T' message 
1s not produced. Instead DL/I produces messages indicat- 
ing the explicit reason for the ABEND. 


2. Notifies DL/I in the CICS/VYS partition that the batch 
MPS job is ABENDiny. If the condition that caused the 
ABEND originated in tthe batch MPS partition, this will 
cause the batch partition controller task supporting 
this batch partition to issue a CICS/VS ABEND reguest. 


3. Deletes the XECB defined by this partition (DLZXCBn1). 
4. Depending on the Setting of the UPSI byte, optionally 


produces a storage dump if the abnormal termination 
routine was entered via a STXIT PC or STXIT AB. If 
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DL/I's abnormal termination routine was entered directly 
from DL/I rather than through a STXIT, a dump is always 
produced, regardless of the UPSI setting. | 


5. Cancels the job. Any remaining job steps in the job are 
not executed. 


Because DL/I always uses STXIT AB and STXIT PC in a batch 
MPS environment, your application programs should not use 
any facilities that require STXIT AaB or STXIT PC. To do so 
would disrupt DL/I's abnormal termination routine and would 
cause unpredictable errors in the CICS/VS partition, possi- 
bly causing it to abnormally terminate as well. 


If DL/I MPS fails to complete its ABEND processing the DL/I 
XECB defined in the batch partition will be deleted by the 
supervisor at end of job 1£ not deleted by the program. 


When CICS/VS 1.3 or later ReleaSe 1S installed and Dynamic 
Transaction Backout is generated, all updates done ayainst a 
Data Base known by CICS/VYS will be backed out by oDTB up to 
the last Synch-Point record. 


How to restart a MPS Batch program is described later under 
the heading ‘Restarting MPS Batch Programs’. 


For a DL/I application task ABEND, including the ABEND of a 
MPS batch partition controller task, DL/I's abnormal termi- 
nation routine performs the following functions: 


1. Writes a dump of the DL/I control blocks and related 
information that are unigue to that task on the CICS/VS 
dump data set. 


2. If the ABENDing task is a MPS Batch Partition Controller 
task, the XECBs defined by that BPC are deleted. 


3. Issues a TERM call on behalf of the ABENDing task to 
cause any data base records altered by that task which 
are Still in main storage to be written back to the data 
bases. This action will also cause any log frecords 
reflectiny these chanjes to be written to the log. If PI 
was used for this task, any DL/I records or segments 
enyueued for this task are released. 


4. Writes a DL/I termination record on the log and a 
CICS/VS synch-~point record on the CICS/VS system jour- 
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nal. 


5. Releases any DL/I resources that belong to this task, 
e.g. PST, PPST, PSB, etc. 


6. Returns control to CicsysVs. 


DL/I and CiCS/VS do not terminate in the event of a DL/I 
application task ABEND. DL/I data baseS are not closed ona 
task ABEND condition. If CICS/VS Dynamic Transaction Backout 
Was Specified for this task, CICS/VS would have performed 
that processing prior to DL/I's abnormal termination routine 
jaining control. 


If for this online task Automatic Transaction Restart was 
specified, CICS/VS would perform this function. 


DL/ZI SYSTEN ABEND (INTERNAL ERROR) 
For the condition where DL/I has detected an internal error 
Which does not permit it to continue processing, the DL/I 
abnormal termination routine performs the following func- 
tions: 


1. ABENDS all DL/I tasks for which it is currently proces- 
Sing a call with a CICS/VS ABEND code of 'DBO6z2*. 


2. Disables the CICS/VS-vL/I interface. An error code will 
be returned in the TCA to any DL/I tasks attempting to 
issue a DL/I call after this condition occurs. 


3. Writes the 'DLZ062I' message on the system console. 
4. Returns control to CICS/VS. 


Note that no attempt is made to close DL/I data bases on 
this type of error. No DL/I task termination records are 
Written on the log either. However, CICS/VS will write its 
own task termination record on the CICS/YS system journal. 
Because of the presence of the CICS/VS end of taSk record on 
the CiICS/VS system journal, CICS/VS emergency restart 
processing will not consider these tasks to be ‘in-flight! 
and thus will not attempt to back them out. However the DL/I 
Backout Utility, if executed in batch, will back out the 
data base updates made by these tasks Since there is no DL/I 
termination records on the log. 


DL/I does not terminate CICS/VS on this condition. CICS/VS 
remains operational so that non-DL/I tasks may continue to 
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be processed. 


If the DL/I tasks that were ABENDed as a result of the DL/I 
error have dynamic transaction backout specified, cCICS/VS 
Will attempt to back out the effects of the DBL/I updates 
made by the tasks. This attempt will fail however, as the 
DL/I interface will be disabled. Dynamic Transaction Backout 
provides a user exit to handle such error conditions. 
Depending on the critical nature of the data bases it may be 
appropriate to terminate CICS/YS at this point. DL/I itself 
does not provide any user ABEND exits. When a CICS/VS 
Shut-down is later attempted, BL/I will issue a 'DLZ0681' 
message and no attempt will be made to close its data bases 
at that time either. The DL/I log, if not assigned to the 
CICS/VS system journal, will be closed at CICS/VS shut-down 
however. 


Tf cCIcS/VS is terminating abnormaliy, the DL/I abnormal 
termination routine performs the following functions: 


1. If the DL/I log 1s not assijgned to the CICS/VS systen 
joutnal, the log buffer is flushed, the log is ciosed, 
and the DOS/VS subtask for the DL/I log is detached. 


2 Lf MPS was active it deletes all xXECHS that had been 
defined. 


3. Writes the 'DLZ070' message on the system console. 


4. Attempts to load and execute the DL/I online formatted 
dump program 'DLZFSDPO',. This program must be specified 
in the CICS/VS PPT for this step to execute. 


5. Returns control to CICS/VS. 


Note that no attempt 1S made to close the DL/I data bases on 
this error condition. However the VSAM automatic close 
facility will be invoked by DOS/VS end-of-job processing to 
close the VSAM data sets used by DL/I. DL/I task termination 
records are not written to the DL/I log on this error 
condition. CICS/VS will not write its task termination 
records on the CICS/VS system journal on this ABEND condi- 
tion. Thus either CICS/VS emergency restart or the DL/I 
 Backout Utility executed in batch can back out the effects 
of the inflight tasks. | 


If CIcs/vVS faiis to complete its ABEND processing, the DL/I 
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XECBS will deleted by the Supervisor at end of job. 


POWER FAILURE 


In case of a Power Failure, execute emergency restart of 
CICS/VS which will backout all in flight tasks at failure 
time. MPS Batch jobs will be backed out as weli up to the 
last synch point/checkpoint issued. 


et 
cH 


RESTARTING BPS BATCH PROGRAMS 
If the user takes advantage of the MPS and PI facility, he 
is recommended to issue periodic checkpoint calls from his 
batch program to avoid excessive queue length (built up by 
PI) and keep control block size to a minimum. 


If he is usiny checkpoints, he needs a restarting procedure 
which iS his responsibility. DL/I provides no mechanism for 
this function, | 


If CHKP-calls are used by Batch and MPS-Batch programs, the 
user must take care on repositioning Seguentail input/output 
files, restoriny interim results like subtotals etc. into 
the appropriate program location. 


Subseyuently the steps to be performed for 4 MPS Batch 
restart are listed. Please note that this 1S a proposal. 
This Solution has not been submitted to any formal IBM test. 
Users Should evaluate its usefulness in their own environ- 
ment prior to justification or implementation. 


Step 1: Create a ‘User Checkpoint Data Base’ containing root 
only segments, one root per program. The root 
segment consists of the following fields: 


~ Keyfield: Projyram Number/Nane 

~ Field 1: DL/I Checkpoint number 

- Field 2: Number of input records read 

- Field 3: Number of output records written 


- Field 4Y-n: Interin results 


Step 2: Application programs must be modified to contain the 
following code: 


a) At start the user application program checks the 
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Checkpoint number of the corresponding segment in 
the "User Checxpoint Data Base’. [If the number is 
QO, branch to normal program execution (this is 
not a restart). If the Checkpoint number is not 0 
(it iS a restart), open an additional output file 
(1£ sequential output is used to copy the number 
of output records to that tape). Read the number 
of input records already processed into storage 
and branch as many times around the get input 
processing routine as necessary. If the number 
1S reached, the input file is positioned correct- 
iy for continuation of normal processing. 


If a sequential output file is used, copy the 


appropriate number of records from ociginal 
output file to the new output file. At comple- 
tion, the Sequential output is positioned 
correctly. 


Before continuing with normal processing, restore 
the interim data into the appropriate fields 
Within the program. 


Db) Within application program logic itself, the user 
must immediately before the DL/I Checkpoint Call 
include a ‘User Checkpoint Call*'. In this call 
the user must update the appropriate segment in 
the ‘User Checxpoint Data Base’ with: | 


~ the value of the DL/I Checkpoint number he 15 
going to write, 

- the number ot input records read, 

- the number of output records written 

~ the values of the interin data maintained in 
the appl. progran. 


c) Issue the DL/I Checkpoint Call. Note that posi- 
tion is lost within the data base after the DL/I 
Checkpoint. The user must reposition himself in 
his data base pefore resuming Further processing. 


d) At successful termination of program execution, 
update the appropriate segment in the ‘User 
Checkpoint Data Base’ with the Checkpoint number 
of 0. 


This 1S a way to restart a MPS batch job, if DL/I Check- 
points are used. The DOS/VS Checkpoint in connection with 
the DL/I Checkpoint cannot be used, aS there is no 
‘reconnect! of the MPS-batch partition to the cicsy/VS 
partition. 


This solution has the following additional benefits: 
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° Appart from mounting an additional new tape if sequen- 
tial output processing on tape is performed by the 
application program, no special operator intervention is 
required in case of restart. The operator haS just to 
read in the job-cards again. (fhus reducing exposure of 
damages due to wrony operator handling). 


* Even in case of an ABEND between updating the ‘User 
Checkpoint Data Base’ and writing the CL/I Checkpoint, 
the 'User Checkpoint bata Base! will reflect the correct 
values, as Dynamic Transaction Backout will backout this 
data base as well to the previous DL/I Checkpoint. 


e Users might expand on the content of the ‘User Check- 
point DB's! root segment to include a field, containing 
a value each time the program terminatea successfully. 
This value can be checked/reset before a Subsequent 
program Starts its execution etc. 


The only ways to restart if files (ISAM, DAM, VSAK etc.) are 
updated besides the DL/I data bases are the following ones: 


a) Migrate the files to DL/I root only data bases. 


b) If the file updates are completeiy independent from the 
DB processing, uSers might consider restoring the file 
content from a SAVE tape before Starting the application 
program. Execute during restart processing ali the 
necessary code to update the file again. 
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Following iS an example of USer/DL/I Checkpoint and restart. 


F cieead 


Read from 'USER CHKP-—DB' root segment JOER~1 
Checkpoint number is 0. | 

Read first input record. 

Issue PREPL*'—Call 


Read 100th input record 
Issue 'REPL*—Call 


Woite *USER—-CHKP' Record 1 1 | 100 j] Interim Resuits | 
to ' USER CHKP-—DB?* ies Dee BS ee ered 


Issue DL/I CHKP—Call 


Write 'USER-—CHKP*® Record i 3 {| 275 |] Interin Results | 
to ‘USER CHKP—DB* Siecle ieee 


v4 


@aenpeexsnsst89 82 @ 8 


oe 223 3929 2. 2 8 08 8 


FAILURE 


BACKOUT PROCESSING 


AR RES RET ED CS CSA SON RT CRA cattetiS MD. aD —enRMS —arkfiete —<tamaEh ANS Sate: ED 


RESTART JOB 1 


ml Rake Aoariae sma MNES “WON menrene conan ReeeTS eben. RAGS eee seme 


Read from ‘USER CHKP—DB' root segment JOH-1 


-— Checkpoint number is not 0 

— Skip 275 input records 

— Restore Interim Results 

—~ Read 276th input record 

— (Continue normal processing) 
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8.3.18 DOS/YSE SUPERVISOR GENERATION 
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The following 
Supervisor in order to run DL/I DOS/VS Version 1.5 with MPS 


and 


required. 


Pi. 


SUPVR 


The 


previous 


Note that 


parameters must be specified in the DOS/VSE 


DOS/SYSE or a Subsequent release i8 


MODE=370|E This is a new parameter. Specifies 


NPARTS=3]n 


PAGETN=n 


whether the Supervisor 18S generated for 
f310-Hode or ECPS:VSE-BMode. The default 
1s ECPS:VSE-Mode. 


Note that this parameter has changed. 
Default 1S 3; the minimum value 1S 2. 


Required because DL/TI LDOS/VS and 
CICS/LOS/VS use the RELPAG macro. This 
is also required if the anticipatory 
paging feature of CICSy/DOS/VS is used 
(ANTICPG parameter in the PCT). Set 
PAGEIN at least equal to the AMXT value 
of your CICS/DOS/VS system when uSing 
the ANTICPG feature. 


TP=BTAM|VTAM Required by CICS/DOS/VS. Note that the 


Specification of VIAM includes BTAM-Sup- 
port automatically. 


parameter AP=YES (in the SUPVYR macro), necessary in 
releases of bOS/VS 1S opsSolete and Standard in 


DOS/VSE. 


FORT 


WTSC 


BOE 


XE 


iil 


we 


B=n 


Reyuired for DL/I DOS/SVYS MPS. A specifi- 
Cation of 'YES' 1s not enough anymore as 
With Version 1.5 of ODL/I the all parti- 
tion MPS Support is inciuded. The 
following formula can te usSed to calcu- 
late the minimum number of XECBs to be 
generated: 

2+(2* (N+M)) where N 18S the number of 
partitions jenerated in the Supervisor; 
Mis the maximum number of concurrent 
MPS tasks. M and N can vary from 2 to 
ds 

AS soon aS MPS 1S Started, 2 xXECBs for 
each partition in the system are defined 
plus 2 additional ones for the whole 
System. (e.g. 5 partitions generated and 
MPS started would result in 12 XECBs 
Which are used up Without any MPS 
processing in progress). Each active 
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batch MPS task requires 2 other XECBS 
during their execution. Do not forget to 
consider that you might need more XECBs 
defined than used by PS only, if there 
are other programs using XECBs. In 
particular, the use of the VSE/POWER 
Cross partition COMMUNICaAtion macros 
GETSPOOL, cCTLSPCOL and pUTSPOOL will 
require two XECBs. 


If you already are usSing XECBS, you should ensure that the 
hames you are using do not conflict with those of DL/I 
DOS/VS. The XECB names DL/I uses are?; 


DLZXCBn0 
DLZXCBn1 
DLZXCBn2 
DLZXCBn3 


where 'n' is a number from 1 to 7, 


DLZXCBOO 
DLZXCBO1 


Note that the XECB names DL/I bDOS/VS MPS usesS cannot be 
Changed by the user. Thus you cannot run copies of DL/I MPS 
in different CICS/DOS/VS partitions concurrently. The second 
CICS/VS-DL/I MPS partition to start would detect that the 
unique MPS XECB names already exist and messaye Dizos2t 
would be issued to the terminal. 


All the other parameters needed in previous DOS/VS Reieases 
in the FOPT macro (1.@. <AB=Y8S, IT=YeS, GETVIS=YES, OC=YES, 
PC=YES, PCIL=YES, PFIX=YES, RELLDR=YES, TOD=YES, VSAM=YES) 
are obsoleted parameters and became standard. 
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8.3-19 VSEZVSAN CONSIDERATIONS 
DL/I DOS/VS is using VSE/VSAM as itsS access method. There- 
fore all considerations outlined in the ‘DOS/VSE Planning 
Guide! Volume 1 Chapter 5 apply basically for wbLyI DOS/SVS 
data bases too. 


When VSE/VSAM Access Method Services (AMS) is used, the new 
architecture 1S tranSparent to users, except that disk 
addresses must be Specified in terms of block numbers rather 
than relative track numbers. Similarly the size of a data 
Space or data Set can be specified only in terms of *number 
of records! or ‘number of blocks', put not in terms of 
cylinders or tracks. fhe specification of disk addresses 1s 
generally necessary in VSAM and AMS for the allocation of 
data spaces. Any information concerning disk addresses or 
extent sizes will also be in units of blocks. 


The fundamental unit of transfer between the system and the 
FBM devices are 512 byte blocks of data, which 18 externally 
invisible to the VSE/VSAM uSer. 


Following are some chapters you should read in the DOS/SVSE 
Planniny Guide in order to avoid mistakes in using VSE/VSAM 
and FBM. 


° VSE/VSAM/AMS Changes for FBM Support 
* Definition of Data Space and Catalog 


° CLASS/SUSECLASS Parameter 


oe ma ite ee aso aa CO CED SD owt aa ERTS ENT ATT NE CE SERN ee ERD OGD ie wee Na a a ea 


Share option 1 iS the only VSE/VSAM share option that should 
be used with any VSAM and YSE/VSAM data set being accessed 
by DL/I DOS/VS. DL/I DOS/VS operating in an MPS environment 
does not reyguire any different VSAM share options than DL/I 
DOS/VS operating ina non-MPS environment. Since any DL/I 
batch MPS programS residing in different partitions are 
really accessing the data bases through a common partition, 
the CICS/DOS/VS partition, VSAM Share option 1 is suffi- 
cient. | 


VSAM Share option 2 provides no functional benefits because 
DL/I always opens its VSAM data sets for update. 
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VSAM share option 3 should never be used in conjunction with 
DL/I. It provides no protection against inadvertent schedul- 
ing of non-MPS DL/I programs that update the same data 
base(s) in different partitions simultaneously. Damage to 
data bases uSed in this manner may yo undetected for some 
time, after which recovery becomes very difficult. 


VSAM Share option 4 does not apply to ESDSS processed at the 
control interval level (the way DL/I processes its HD ESDS 
data bases). In addition the use of Share option 4 may cause 
the loss of data base (SHISAM, HISAM and INDEX) updates 
because of the way in which ODL/I accesses a VSAM KSDS for 
update. 


DL/I does not Support concurrent access to data bases from 
more than one partition, except in an MPS environment. No 
attempt to access data bases concurrently should be made 
except through NPS, as data baSe damaye may occur. 


CONVERSION CONSIDERATIONS 


If you have your data bases to move to an FBM device, the 
following steps must be executed: 


* Unload or Export(ra) your data base({s) from CKD device. 


* Regenerate the affected DBD's and run the block builder 
to catalog them to the systen. 


e Define data base Space and Cluster as a new FBA file on 
an FBM device with AMS Define command. 


° Use Reload or Import(ra) to have your data base({s) on 
the FBM device. 


Note that the meaning of the 'SCAN=' parameter on the 
DATASET statement of the DBD-Macro will now indicate physi- 
cal FBM blocks to be Scanned. This chanye iS triggered 
internally in the DBDGEN macros when DEVICE=FBA is speci- 
fied. Evaluate the usefullness of the CLASS/USERCLASS 
parameter in connection with Databases. For details refer to 
the DOS/VSE planning Guide Volume 1, Chapter 5. 


If you do not move your data bases to an FEM device you can 


process your existing databases without any modification in 
the area of DBDGEN/ACBGEN or VSAM. 
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8.3.20 CICS/DOS/VS GENERATION 


CICS/DOS/VS Rel. 1.4 or a SubSequent release is required for 
DL/I DOS/VYS Version 1.5. 


CICS/DOS/VS Rel. 1.4 or a Subsequent releaSe iS required for 
1 


4 
DL/I DOS/YS Rel. 1.5. 


The parameter 'DLI=YES*' must be specified in the DFHSG 


TYPE=INITIAL macro to generate Support for DL/I bDOS/VS in a 


CICS/DOS/VS system. This is independent of whether or not. 
MPS or PI will be used. There are no parameters for 
CIcS/DOS/VS system generation specifically for DL/I MPS. 
DL/I PI requires CICS/VS Dynamic Transaction Backout 
Support. 


For ease of maintenance the preassembled CICS/VS programs, 
distributed in the starter system core-image library, are 
highly recommended. 


Certain ODL/I macros, identified by their BLZ names, are 
included in the cICS/DOS/VS Release 1.4 in order to avoid 
assembly errors in cCICS/VS intersystems communication 
modules. (1.e. ODLZRIB, DLZRPDIR, DLZRPCB, DLIUIBO). When 
DL/I DCS/YVS Version 1.5 is installed the dummy CICS supplied 
macros are replaced with real [EL/I code. After installation 
of DL/I, the CICS/VS modules which include the replaced 
macroS must, of course, be re-assembled. The affected 
modules are: 


DFHISP DFHXFP 


The following module should be reassembled for performance 
reasons: 


DFHMIR 


The following modules reference DL/I bSECT and reassembly is 
Suggested for security reasons: 


DFHRUP DFHTBP DFHDBP DFHJCP 
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There is aiso a set of DL/I modules which must always be 
cre-assembled when a new CICS/VS release is installed: 


DLZOLIOO0 DLZSTPOO DLZRDBLI DLZBMPCOO CLZEPCOO DLZEPIOO 


DLZNSTRO DLZNSTPO DLZODP DLa4FIDPO DLZQUEFG 


If you choose not to use the preassembled programs provided 
in the CICS/DOS/VS starter system library, you Should ensure 
that your Staye I CICS macros include the appropriate 
programs and parameters for DL/I. 


tf you already have an operational CICS/SVS system and you 
want to add Support for DL/I without performing a complete 
new generation, the following CICS/VS management modules 
must be reassembled with the BDL/I global, &LLIGEN, turned on 
(EDLIGEN SETB 1). Note that the DL/I globai in the Journal 
Control Program 1s &JCDLI not &DLIGEN. 


DFHSRP system Recovery Progra 

DFASTP System Termination Prograa 

DFHPCP Program Control Progran 

DFHSIP System Initialization Program 

DFHFCP File Control Program 

DFHJCP Journal Control Program (if logging to 
CICS/VS journal) 

DFHTBP Transaction backout Program (if CICS/VS 
Emergency Restart is to be used) 

DFHDBP Dynamic Transaction Backout Program (if 
CICS/VS dynamic tranSaction Support is to 
be used) 

DFHEIP Exec Interface Program (if RPG-I{f online 
processing or [SC is to be used) 

DFHEXP Command Languaye Translator Program (if 
RPG-II online processing 1S to be used) 

DFHISP Intersystem Program (if ISC is to be 
used for remote DB access) 

DFHXFP Transformer (if ISC is to be used for 
remote DB access) 

DFHTCP Terminal Control Program (if remote DB 
access is used) 


Note that although a DL/I global exists in FCP, DL/I does 
not currently use any FCP support. (VSAM Support in FCP is 
not reguired). 


The batch Partition Controller program {DLZBPCO0) was 
non-reentrant in BL/I releases 1.2 and 1.3 and so MPS could 
not be used in conjunction with the subset option of 
CICS/VS. This restriction no longer applies Since DL/I 
release 1.4. 
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The following is an example of the parameters tLtequired in 
the various CICS/VS system generation macros to support 
UL/I. This example is not intended to be a complete CICS/VS 
yeneration. Rather it only shows those parameters affected 
by the presence of DL/I in a CICS/VS system. The numbers on 
each line refer to the comments below. To generate the ISC 
support, please check in Chapter 8 of this planning guide. 

1. ODFHSG TYPE=INITIAL, DLI=Y2S,VSAM=YES,.... 

22 DFHSG PROGRAM=DBP,SUFFIX=01,.....4. 

3. DFHSG PROGRAM=EIP 

“4. ODFHSG PROGRAM=EXP, LANG=(.....2. 

5. DFHSG PROGRAM=FCP,DUMMY=YES,... 

62 DFHSG PROGRAM=ISC,.... 

7. %DFHSG PROGRAM=JCP,AUTOJRN=YES, DTB=AUX|MAIN,... 

8. DFHSG PROGRAM=TCP,VTAMDEV=LUTYPE6,.... 

9. DFHSG PROGRAM=TBP,.... 

10. DFHSG PROGRAM=TSP,AUX=.... 

DFHSG TYPE=FINAL 

1. DLI=YES must be specified whether or not MPS or PI 
Support iS uSed. It PI support is used, then VSAM 
support will normally be required for CICS/VS Temporary 
Storage (but 1s not essential Since Temporary storage 
could be provided in MAIN storage). 

2. The cCICS/VS Dynamic Transaction Backout program 15 
required if DL/I PI support is used. In this example it 
is generated with a suffix of 'OT'. 

3. The CICS/VS Exec Interface Program iS required if online 
RPG II programs are to be supported. Note that MPS-batch 
programs written in RPG do not require the presence of 
EIP in the CICS/VS systen. 

4. The cCICS/VS Command Languaye Translator Program is 
required to support all online programs written in RPG 


Tis 


5. Note that VSAM support iS not required in FCP to support 
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DL/I. A dummy FCP may be used in the (unlikely) situa- 
tion in which a CICS/VYS system Supports only DL/I data 
bases. | 


The CICS/VS Intersystem Communication Program must be 
generated, if a data base on a remote system has to be 
accessed. Note that VTAM=YES is required in the DFHSG 
TYPE=-INITIAL macro. | 


Required to support CICS/VS Emergency Restart of a 
System with ODL/I transactions and dynamic transaction 
backout when selected. Aliso reyuired in all systems for 
which the DL/I logging function is routed to the CICS/YVS 
system log. Note DL/I Program Isolation requires DTB and 
that AUTOJRN=YES must always be specified, VSAM support 
must be specified in the DFHSG TYPE=INITIAL macro and 
the DFHSG PROGRAM=TSP is also required. 


lf a remote data base has to be accessed, the LUTYPE6 
parameter 1S required to generate an appropriate Termi- 
Nai Control Program. This parameter requires that VTA 
Support hasS been generated in the DFASG TYPE=INITIAL 
request. 


If CICS/DOS/VS Emergency Restart support of DL/I tran- 
Sactions is used, the transaction backout program must 
be generated. 


TSP is required by DL/I only when DTB=AUX has heen 
specified to support Program [Isolation (See above). 


However it is very likely that this function will also 


For 
Cics 


r 
J 
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be required to support online user programs. 


DL/I DOS/VS support within CICS/DOS/VS the following 
/¥S tables require specific entries. 


CT File Control Table 

cr Journal Control Table (if Loyging to CICS Journal) 
CT Program Control Table (if MPS or PI used) 

LT Program List Table 

PT Program Processing Table 


SIT System Initialization Table 


T 


CT Terminal Control Table (ISC Support) 
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File Control Table (FCT) 

There must be an entry in the FCT for each DL/I data base 
referenced either by an online DL/I transaction or by a 
batch DL/I MPS proyranm. This includes not only the data 
bases accessed logically by the application code, but also 
includes all data bases that are related physically by DL/I 
to the logically accessed data bases. Therefore the follow- 
ing types of data bases must have an entry in the FCT: 


HDAM Data Bases 

HIDAM Data Bases 

HIDAM Primary INDEX Data Bases 

HDAM and HIDAM Secondary INDEK Data Bases 
(S)HISAM Data Bases 


For example, where a loyical data base iS composed of a HDAMN 
and HIDAM data base and each of these physical data bases 
haS a secondary index, the FCT would have to contain the 
following five entries: 


HDAM Data Base 

HDAM Secondary INDEX Data Base 
HIDAM Data Base 

HIDAM Primary INDEX Data Base 
HIDAM Secondary INDEX Data Base 


i > tw BD ws 


There would not be an entry in the FCT for the logical data 
base. The only parameters that should be Specified are 
dataset name (use the DBDname from the PCB statement), 
access method (DL/I), and open option (INITIAL or DEFERRED). 


Since these entries are only referenced during systen 
initialization processing they should be grouped with other 
low activity entries in your FCT. 


Remote data bases do not have to be defined in the FCT by 
uSing the DFHFCT TYPE=REMOTE macro request as you have to do 
for other files which CICS has to access inthe frcemote 


system. DL/I get the necessary information from the ACT. 


Journal Control Table (JCT) 

For DL/I logging to the CICS/VS system journal, the buffer 
Size can be specified in the range of 1024 Bytes (minimum) 
to 32767 Bytes (maximum). 


You might choose to increase the CICS/VS Log Blocksize, when 
there is a Small percentage of Force-writes anda high 
percentage of Log-Waits. Therefore review your existing JCT 
specifications. 
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DFHICT TYPE=ENTRY, JFILELD=SYSTEM,... 
JOUROPT= (CRUCIAL, RETRY, INP... 
BUFSIZE=4096,.e- 
SYSWALT=STARTIO (1.4 CICS) 


Note 1: If a buffer size other than (the default) 1024 Bytes 
is Specified, it will be necessary to change 
Li-statement input to the following DL/I utilities: 

Log Print, Data Set Recovery, Backout, Change 
Accumulation.The buffer size must be specitied in 
columns 31 to 35 (left-justified) of the LI-state- 
ment. 


Note 2: If PI is used, the DL/I log must be assigned to the 
| CICS/VS system journal. 


Note 3: If ISC is used, the DL/I log entries go anto the 
CICS/VS journal for the system which supports the 
data base(s) locaily. 


Note 4: Force-Write to the log causes short blocks but is 
required when DB-buffers are written to DASD. Such 
force-writes occur when Index, HISAM and SHISAM data 
bases are updated and the DL/I buffer subpools are 
too small. The task waits when the journal buffers 
are full. There are no statistics available to help 
in log tuning. 

Note 5: Be aware of increased working set size with larger 

DL/I log blocksize and note that the Utilities are 

affected too. 


Ge 


Program Control Table (PCt) 

If DL/I MPS is used there are four DL/I MPS transactions 
which must be defined in the PCT. Tney should be coded as 
follows: 


DFHPCT TYPE=ENTRY,PROGRAM=DLZMSTRO,TRANSID=CSDA 

DFHPCT TYPE=ENTRY,PROGRAM=DLZMNPCO0O,TRANSID=CSDB, TWASIZE=268 

DFHPCT TYPE=ENTRY,PROGRAM=DLZBPCOO, TRANSID=CSDC, TWAS IZE=256, DIB=YES 
DFHPCT TYPE=ENTRY,PROGRAM=DLZMSTPO,TRANSIU=CSDD 


These four transactions are used as follows: 

CSDA Start MPS operation 

CSDB Master Partition Controller 

CSDC Batch Partition Controller 

CSDD Stop MPS operation 
Since these transactions are probably of low activity 
compared to most of the transactions in your System, their 
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entries should be placed with other low activity entries in 
your PCT. Use the CICS/VS statistics to determine their 
placement in the PcT. These transactions should be speci- 
fied as CLASS=LONG. 


Only the CSDA and CSDD transactions should ever be entered 
from a terminal. The CSDB and CSDC transactions are inter- 
nally attached by DL/I MPS. If either CSDB or cCSDC is 
entered from a terminal, the Master Partition Controller and 
Batch Partition Controller programs will ignore the request 
(Without sending a message to the terminal). 


Since the CSDA and CSDD are Special transactions you will 
probably want to put a transaction security on these so that 
they can oniy be executed by the master terminal operator or 
other such uSers. 


Note that Since these transaction-ids start with the letter 
‘ce you cannot use the cICS/VYS TCLASS/CKEXT facilities to 
control their execution, 


If PI is used, then all DL/I transactions must be marked for 
dynamic transaction backout (DTB=YES). Failure to do So can 
cause loss of data base integrity. For batch MPS operation 
With program isolation, the CSDC transaction must be marked 
for dynamic transaction pbackout. The other three DL/I MPS 
transactions do not issue DL/I calls and need not have DTB 
Specified when PI is used. 


There are two ways of specifying remote DE-access in the 
PCT: 


a) All processing is dune in the remote systen 
including the DB-access; 


b) DB-access only iS done in the remote systen. 


If the processing program 1S in the remote system, the 
following PCT entries are required: 


DFHPCT TYPE=ENTRY,SYSITb=name, RNTNAME=name, TRANSID=nane 
DPHPCT TYPE=GROUP,FN=I5SC 


For this type of remote processing, there iS no need to code 


remote PSBS in the AcT. There is, as well, no need to have 
DL/IT runniny in the local systen. 
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If the processing progran is in the local system, but the 
referenced data base(s) in the remote system, the following 
entry has to be done 


DFHPCT TYPE=GROUP,FN=ISC 


Note, that in this case you have to Support DL/I in both 
CICS/VS systems. Note, as well, that the Mirror transaction 
(DFHMIR) must not be eligible for CICS/VS automatic transac- 
tion restart. 
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DL/I will not process any MPS batch programs until the 
Master Partition Controller program is initiated in the 
CICS/VS partition. This program can be initiated in two 
ways: 


1. By a terminal operator entering the transaction 
*'CSDA®. | 


2. By letting CICS/VS execute the MPS start progran 
(DLZMSTRO) during its system initialization proces- 
sing. 


If the second option is taken, a start-up PLT must be coded 
With the DL/I MPS Start program as one of the entries. The 
suffix of the start-up PLT must pe specified in the *PLTPI' 
parameter of the SIT. 


If you want to have DL/I MPS stop automatically when CICS/VS 
Starts its shut-down processing you Should make an entry in 
the shut-down PLT for the program DLZMSTPO. This entry must 
appear before the DFHDELIM entry. 7 

DL/I requires an entry in a sShut-down PLT for the progran 
DLZSTPO0O following the DFHDELIM entry. This 18 required 
whether or not HPS is used. The suffix of this shut-down PLT 
must be specified in the 'PLTSD' parameter of the SIT. 


Do not forget to code the PLT names in the PPT! 
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PEocesstys Program Table (PPT) 

When DL/I MPS is used the four programs referenced by the 
four DL/I MPS transactions must be defined in the PPT. They 
Should be coded as follows: 


DFHPPT TYPE=ENTRY,PROGRAM=DLZMSTRO 
DFHPPT TYPE=ENTRY, PROGRAM=DLZMPCOO 
DFHPPT TYPE=ENTRY, PROGRAM=DLZBPCOO 
DFHPPT TYPE=ENTRY, PROGRAM=DLZMSTPO 


Failure to define all these entries in the PPT will yield 
unpredictable results if MPS operation iS attempted. 


Since these programs are probably of low activity relative 
to the regular online programs they should be placed with 
other low activity entries in your PPT. Since DLZMSTRO and 
DLZMSTPO are low usage (normally used only once per CICS/VS 
session) they should be specified as RES=PGOUT. DLZ2MPCOO and 
DLZBPC00O Should be specified as RES=YES for best perfor- 
mance. 


DL/I also requires an entry in the PPT for the program 
'DLZFSDPO' af a DL/I formatted dump is to be produced on a 
CICS/VS ABEND. Since this may aid in problem determination 
when a CICS/VS ABEND occurs, it is a good idea to include 
this program in your PPT. Since both DLZSTPOO and DLZFSDPO 
are oniy used once per CICS/VS session, they shouid be 
specified as RES=PGOUT for best CICS/VS system performance. 


Note that the specification for program residence options 
can aiso be made via an ALT. 


For ISC support, the following entry iS required: 
DFHPPT TYPE=GROUP, FN=ISC 


This entry generates the Mirror tranSaction DFHMIR (Supplied 
with CICS/VS) referenced in the DLZACT definition. 


System a eee oot! Table (SIT) 

The SIT must have *DLI=YES* or ‘'DLI=xx' specified. In 
addition, bL/I reyguires entries in a Shutdown PLT and 
optionally in an initialization PLT. Specify the suffix of 
the appropriate initialization and shutdown PLTS in the 
PLTPI and PLTSD parameter respectively. 


Each active batch MPS program will require a CICS/VS task to 
Support it. If you have remote programs accessing your 
local DL/I data base, you must add for each such remote 
system one CICS/VS task to support it as well. Therefore 
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you may want to increase your current AMXT and MXT specifi- 
cations. Note that the DL/I MPS Master Partition Controller 
task (CSDB) 1S not counted by CICS/VS when calculating the 
number of active tasks for AMKT purposes, just as the 
CICS/VS terminai control, task control and journal control 
tasks are not counted. | 


For support of Inter System Communication the ISC=YES 
parameter must be specified. (If you need suffixed modules 
specify ISP=xx and XFP=xx instead of ISC=YES). 


Terminal Control Table (TCT) 

The CICS control blocks required to define the VTAM link to 
another CICS system are generated by the DFHTCT TYPE=ISLINK 
NMacro. This entry is required to establish the ISC support. 
Refer to the CIics/bDOS/VS SRL for detailed information. 


DLZE DOSZVS APPLICATION CONTROL TABLE 


The online DL/I DOS/VS Application Control Table (ACT) has 
two functions. One function is to provide DL/I with environ- 
mental anformation such as buffer pool Size, UMB assign- 
ments, maximum number of concurrent DL/I tasks that may 
execute, PI support, ISC etc. 


With ODL/I DOS/VYS Version 1.3, PI support is provided by 
defauit. If you do not wish to use PI with your DL/I systen, 
then you must also specify the parameter 'PI=NO' in your 
ACT. For good documentation you should specify ‘'PI=YES’* in 
those ACTS where PI support is desired, instead of letting 
it detault. This way your intentions are clearly documented. 


An entry in the ACT for the CICS/DOS/VS Dynamic Transaction 
Backout Program 1S needed if PI=Y#S 15 specified. Reason: If 
the DFHDBPxx program abends trying to back out a transac- 
tion, DL/I voOSsS/VS will receive control to service the abend 
and prevent a possible CICS/DOS/VS-DL/I DOS/VYS abend. The 
PSBNAME you specify for this program does not matter since 
it does not issue a PCB call. | 


If you have an existing CICS/DOS/VS-DL/I DOS/VS systen 
Without MPS generated, you Should review your current ACT 
environmental parameters (MAXTASKS, etc.) to see if they 
require changes for MPS or ISC. Each active batch DL/I MPS 
program will require a Batch Partition Controller (BPC) 
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transaction in the online system to support it. For ISC you 
need a Mirror transaction for each remote system. Therefore 
you may need to increase the values of MAXTASK and CMAXTASK. 
If you are introducing more data bases into the online 
system {those that were formerly used only in Latch and now 
are to be accessed via MPS) you Should examine the size of 
your buffer pool and DMB assignments. 


The second function of the ACT is to define the valid 
application program and PSB combinations for the online 
system. When an online DL/I transaction attempts to schedule 
a PSB, DL/I checks to ensure that the program issuing the 
scheduling cali iS authorized to use that PSB. DL/I accoa- 
plishes this by scanniny its ACT for the name of the 
requesting program. Once DL/I locates the program name in 
the ACT, it then checks to see if the requested PSB is 
authorized for that program. | 


Since all batch MPS programs actually communicate to DL/I 
through the BPC running in the online partition, you must 
make an entry ain the ACT for this program. You should list 
With this program the names of all PSBS that will be used 
with MPS batch application programs. Note that the DL/I 
utility proyrams cannot run under MPS. Nor can you execute 
any batch DL/I programs under MPS that require a PCB PROCOPT 
of L or use SHSAM or HSAM data bases. The form of this ACT 
entry is as Follows: 


Col 72 
DLZACT TYPE=PROGRAK, © 
PGMNAME=DLZBPCOO, Cc 


PSBNAME= (nahe,nName,..) 


Potentially, a large number of PSBsS can be associated with a 
Batch Partition Controller task for use by different batch 
programs. fhe DLZACT macro will accept up to 4095 PSB names 
(and proyram names). That Should be sufficient for any user. 
The macro language of the DOS/VS assembler, however, will 
accept no more than 255 characters (including parentheses) 
in a sublist used as the operand in a macro. A sublist is 
one or more entries separated by commas and enclosed in 
parentheses, Such as the list of PSB names following the 
PSBNAME key word parameter in the DLZACT macro. Since this 
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probably won't be sufficient for the BPC entry in the ACT, 
DL/I has provided a continuation facility. To continue the 
PSBNAME sublist you code a ‘CONT=YES* parameter on each line 
that is to be continued. An example will make this clearer. 


cc 72 
DLZACT TYPE=PROGRAM, PGNAME=DLZBPCOO, c 
PSBNAME= (PSBA, PSBB, PSBC) , CONT=YES 
DLZACT PSBNAME= (PSBbD,PSBE, PSBF),CONT=YES 

DLZACT PSBNAME= (PSBG,PSBH) 


In this example PSBs A through H are associated with the 
BPC. The use of the continuation facility is not limited to 
the BPC entry in the ACT. 


All programs which issue DL/I schedule (PCB) call and the 
subsequent TERM call must be defined in the ACT. These 
programs must be defined in the ACT even if they do not 
actually issue any retrieve, update or delete/add calls. 


When assembling an ACT a size parameter of at least 272K is 
required (// EXEC ASSEMBLY,SIZE=272K), otherwise the assen- 
bler will terminate with an IPK100 error. 


If you want to acceSs a remote data base via the usage of 
CICS/VS ISC, you must Specify the location of the remote 
PSBs by using a *DLZACT TYPE=RPSB' statements. Each PSB of 
this type defined for use by PL/I programs must be identi- 
fied as a PL/I PSB by the LANG=PL/I parameter on the DLZACT 
TYPE=RPSB statement. All DLZACT TYPE=RPSE statements must 
immediately follow the last DLZACT TYPE=PROGRAM Statement. 
The format of this statement is: 


DLZACT TYPE=RPSB,PSB=psbname,SYSID=systemid[ ,RNAME=remname ] 


where: TYPE=RPSB identifies this statement aS a 
definition of a PSE on a renote 
systen. 

psbname is the name of the PSB specified 


oh any previous 
DLZACT TYPE=PROGRAM Statement. 


systenid is a 4-character identifier of 
CICS/VS system to which the PSB 
and associated data bases are 


assigned. 
remnane is the name given to the PSB in 
remote system. May be 1-8 


chars and defaults to pSbrame. 


Intersystems Communication support iS invoked when the DL/I 
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Program Request Handler (PRH) detects a request to schedule 
a remote PSB. 


When generating a DL/I nucleus to process requests from 
another system, a DLZACT TYPE=PROGRAM statement must be 
Supplied for a mirror transaction, PGMNAME=DFHMIR. The 
mirror transaction issues DL/I calls on behalf of the other 
system. Therefore, the PSBNAME parameter must include all 
PSB names which can be referenced by another system. In 
order to simplify nucleus generation for processing requests 
from other systems, an optional parameter, REMOTE=YES, can 
be specified on the DLZACT TYPE=CONFIG statement. This will 
generate the eguivalent of a DLZACT 
TYPE=PROGRAM, PGMNAME=DFHMIR statement with PSBNAME equal to 
all PSBs defined in the DL/I nucleus. 


ACT SUMMARY: 


The ACT Statements MUST be coded in the following order: 


DLGACT TYPE=INITIAL,.... 
DLZACT TYPE=CONFIG,..02- 
DLZACT TYPE=PROGRAM,.... 
DLZACT TYPE=RP5B,.222002 
DLGACT TYPS=BUFFER,..... 
DLGACT TYPE=FINAL 
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1. Program A in CPU-1 accesses DB-W on CPU-1 using PSB-W 
Program B in CPU-1 accesses DB-X on CPU-1 uSing PSB-X 
Program C in CPU-2 accesses DB-Y on CPU-2 using PSB-Y 
Proyram D in CPU-2 accesses DB-Z on CPU-2 uSing PSB-2Z 


The ACT in CPU-1 Should be specified as follows: 


DLZACT TYPE=INITIAL,SUFFIXK=C1 

DLZACT VZYPE=CONFIG,... 

DLZACT TYPE=PROGRAM, PGOMNAME=A, PSBNAME=8 
DLZACT TYPE=PROGRAM, POMNAME=B, PSBNAME=X 
DLGACT TYPE=FINAL 


The ACT in CPU-2 Should be specified as follows: 


DLZACT TFYPE=[NITIAL,SUFFLIK=C2 

DLZACT TYPE=CONFIG,. 2.205 

PLZACT TYPE=PROGRAM, PGOMNAME=C, PSBNAME=Y 
DLGZGACT TYPH=PROGRAM, POMNAME=C0, PSBNAME=Z 
DLZACT TYPE=FINAL 
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DB-W 
DB-X 
DB-Y¥ 
DB-Z 


accesses 
accesses 
accesses 
accesses 


in CPU-1 
in CPU-1 
in ¢CPU-2 
in CPU-2 


PSB-W 
PSB-X 
PSB-Y 
PSB-Z 


CPU-1 using 
CPU-1 using 
CPU-1 uSing 
CPU-2 uSing 


CO th 


on 
in CPU-1 Should be specified as follows: 


TYPE=INITIAL,SUFFIX=C1 
TYPE=CONFIG,....4. 

TYPE=PROGRAM, PGMNAME=A, PSBNANE=W 
TYPE=PROGRAM, PGMNAME=3B, PSBNAME=X 
TYPE=PROGRAM, PGOMNAME=DFHMIR, PSBNAME=Y 
TYPE=PINAL 


in CPU-2 shoula be specified as follows: 


TYPE=INITIAL, SUPFIX=C2 
TYPE=CONFIG,...6. 

TYPE=PROGRAM, PGOMNAME=C, PSBNAKE=Y 
TYPE=PROGRAM, POMNAME=D, PSBNAMNE=Z 
TYPE=RPSB,PSB=Y,SYSID=CPU1 
TYPE=FINAL 
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1n 
in 
in 
in 
in 


Ci to oe 


in CPU-1 Should be specified as follows: 


CPU] 
CRUZ 
CPeuSt 
CPU-2 
CPUT2Z 


accesses 
accesses 
accesses 
accesses 
accesses 


DE-W 
DE-W 
UB~ i 
DE-Y 
DB~-Z 


TYPE=INITIAL,SUFFIX=C1 
TYPE=CONFIG, REMOTE=YES,.... 
TYPE=PROGRAM, PGMNAME=A, PSBNAME=4 
TYPE=PROGRAM, PsMNAME-B, PSBNAME=X 
TYPE=PINAL 


in CPU-2 should be specified as foilows: 


IYPE=INITIAL,SUPFIX=C2 
TYPE-CONFIG,..... 
TYPE=PROGRAM, PGMNANE=A, PSENAME=W 
TYPE=PROGRAM, PGMNAME=C, PSEBNAMNE=Y 
TYPE=PROGRAK, PGMNAME=D, PSBNAME=2 
TYPE=RPSB,PSB=W,SYSID=CPU1. 
TYPE=FINAL 


on 
on 
on 
on 
On 
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CPU-1 
CPU-1 
CPU-1 
CPU-2 
CPU-2 


using 
using 
uSing 
using 
uSing 


PSB-W 
PSB-W 
PSB-X 
Pop= 
PSB-Z 
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4. Program A in CPU-1 accesses DB-W on CPU-1 using PSB-W 
Program A in CPU-2 accesses DB-W on CPU-1 uSing PSB-W 
Program B in CPU-1 accesses DB-X on CPU-1 using PSB-X 
Program B in CPU-2 accesses DEB-X on CPU-1 uSiny PSB-X 
Program C in CPU-2 accesses DB-Y on CPU-1 uSing PSB-Y 
Program D in CPU-2 accesses DE-Z on CPU-2 using PSB-Z 


The ACT IN CPU-1 Should be specified as follows: 


DLZACT PYPE=INITIAL, SUFFIX=C1 

DLZACT TYPE=CONFIG, REMOTE=YES,...2200 
DLZACT TYPE=PROGRAM, POMNAME=A, PSBNAME=W 
DLZACT TYPE=PROGRAM, POMNAME=B, PSBNANE=X 
CLZACT TYPE=PROGRAM, PUMNAME=DFHMIR, PSBNAME=Y 
DLZACT IYPE=FINAL 


In this ACT, the mirror transaction with PSB 'Y* has to be 
specified in addition to 'REMOTE=YES* because the PSB ‘yY* 
is not used by a local running program as PSB 'W' and *X! 
are. 


The ACT in CPU-2 should be Specified as follows: 


DLZACT TYPE=INITIAL, SUFFIK=C2 

DLZACT TYPE=CONFIG,......2.- 

DL4ZACT ‘TYPE=PROGRAM, PGMNAME=A, PSENAME=W 
DLZACT TYPE=PROGRAM, PGMNAME=B, PSBNAME=X 
DLZACT TYPE=PROGRAM, POMNAME=C, PSBNAME=Y 
DLGZACT TYPE=PROGRAM, PGMNAMG=D, PSBNARE=2 
DLZACT TYPE=RPSB, PSB=W,SYSID=CPU1 
DLZACT TYPE=RPSB,PSB=X,SYSLTID=CPU 
DLZACT TYPE=RPSB,PSB=Y,SYSID=CPU1 
DLZACT TYPE=FINAL 
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several points in the area of programming uSing Field Level 
Sensitivity have to be discussed. In particular 


° Usage of the SSA 
° INSERT-Calls 
* Format of the Key-Feedback-Area 


DOA 7 
The information supplie as an SSA should be in the format 
of the application's view of the field. The field in the SSA 
will be converted to the physical view before the compare is 
done. Any fields overlapping either end of the SSA field 
Will not be converted. 


An applications view of a secondary index can be defined in 
either of two ways: | 


» Following the SENFLD/VIRFLD statements of the target 
Segment (i.e. the root of the PCB) include the SENFLD 
Statement referencing the XFLD statement followed by 
SENLFD statements referencing all the fields specified 
in the SRCH-parameter of the XPLD statement. 


* Make the application program field sensitive for the 
index source Segment and include following its SENSEG 
Statement SENFLD statements for all fields specified in 
the SRCH-parameter of the concerned XFLD statement. 


If both specifications are made, those specified under the 
target segment will supercede the others for the interpreta- 
tion of a SSA refering to the XFLD. The applications view of 
the index source segment will be as specified below its 
SENSEG statement. 


If a PCB specifies an alternate processing Sequence = and 
contains some field level sensitivity for the index source 
segment then one of the two ways must be used to define an 
application view for the secondary index. 


INSERT-Calis 


If field sensitivity for a segment 1S specified in conjuc- 
tion with insert sensitivity, sensitivity must be specified 
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for any sequence fieids in the segment. The field need not 
be identified by name as long aS its area is included in 
sone field tor which sensitivity has been specified. 


Sensitivity for insert of bi-directional logical children 
requires sensitivity to both physical and logical twin 
sequence fields. 


If insert Sensitivity 18S specified for a destination parent, 
the application program must be sensitive to the entire 
concatenated Key. 


The information supplied in the key feedback area will be 
unconverted. 


G.4.2 


There are no implications on the programmer by this line 
item. For the operator, procedures for recovery mus be 
adapted corresponding to the extension of the logical 
database structulLe. 


Ili NOTWIN 15 specified, any attempt to insert or load more 
than one occurrence of this segment per parent results in an 
incomplete DL/I call. The application program isSuing the 
call is notified via a status code (TI for insert and LB for 
load) that one occurrence of this Segment already exists in 
the data base. 


All functions available to)the DL/I CDOS/YS application 


WESC BOE IBM Internal Use 8.101 


Chapter 8.0 DOS/VSE PLANNING GUIDE ZZ10-9826 
DL/I DOSYVS Rel. 1.5 Volume If 


programmer are available under CMS. In addition the applica- 
tion programmer disposes now of VM/370 interactive facili- 
ties and CMS editors and EXECs to develop and test his 
programs. 


By using this support of vL/I under CMS the user can insure 
a better separation of development and production environ- 


ments. Note however that the DL/I utilities can not be 
executed under CMS, 


CA Numeric Truncation Error during length conversion 
occurred. 


CB Character fruncation Error during length conversion 
occurred. 


CC Invalid Packed/Zoned Decimal Character found during 
conversion. 


CD Non Supported Field Conversion (Type conflict). 


CE A call was issued trying to replace a field whereas the 
scheduled PCB does not have replace as procopt. 


Il extended to: only one occurence of the segment is 
permitted. 
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The following aid programs may be used in conjunction with 
DL/I DOS/VS : 


Data Base Design Aid (5748-XxX4) 

DB/DC Data Dictionary (5746-XXC) 

Chained File - DL/I Bridge (5748-XxX3) 

DL/I HBAM Data Base Tuning Aid (5796-AKF) 

DOSMAP - DL/I (5796-PCH) 

Data Base Dump Utility (5796-AJE) 

DL/I Status and Debugging Ald (5798-CGL) 

ISAM-to-DL/I COBOL Translator (5796-PFB) 

Data Base Call Macros (5798-CHR) 

VANDL/I - DL/I Data Base Utility (5798-CDH) 

DL/I Batch Monitor (5796-AKY) 

DL/I Performance Aid (5785-DAX) 

CICS/DOS/VS Testing vLL/I DOS/VS Calls Online (5796-ARN) 

DL/I DOS/VYS Space Management Utilities (5796-PKF) 
{Includes Pointer Validation Utility) 

ISAM to DL/I Bridge (5798-CYT) 

High Speed Utility for DL/I DOS/VS (5798-CYJ) 


The following application programs may be used in conjunction 
With DL/I DOS/YS : 


GIS/DOS/SVS (5799-ALX) 

Bill of Material - DL/I (5798-CLF) 

Material Requirements Planning - DL/I (5798-CNF) 
STEPS DOS/VS (5746-XX2) 

PLANCODE/I DCS/VS (5746-XX9) 

CAPOSS~E DOS/VS (5746-41) 

DMS/VS DOS/VS (5746-KC2) 

DMS/CICS/VS DOS/VS and DOS/VSE (5746-XC4) 
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The following material 
tion with DL/I DOS/SVS : 


ZP72-0812 
ZP73-0618 
Z2P73-0741 
ZP74U-0620 
2P 74-0631 
ZP 75-0642 
ZP 70-0611 
ZP 76-0630 
ZP77-0648 
Z2P77-0648 
ZP78-0748 
ZP 79-0620 
ZP79-0621 
Z2P73-0619 
GH20-42 30 
GH20-4350 
6520-2687 
G520-2943 
GK 10-6050 
GHZ0-1246 
SH24-5001 
SH12-5411 
SH12-5412 
SH12-5413 
SH12-54174 
SH24-5002 
LY¥12-50106 
LYBU-0839 
ZL20- 2833 
G320-6011 
B7 7-03 
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is available to be used in conjunc- 


Program Product Announcement Letter 
CicsSs/DOS/VS Interface Announcement Letter 
Version 1.0 Availability Notice (w/o CICS IF) 
Version 1.0.2 Availability Notice 

Version 1.1 Availability Notice (Log. Relationship) 
Command Code F ICR Announcement Letter 
Tuning Options ICR Availability Notice 
Tuning Options ICR Availability Notice 
Version 1.2 Announcement Letter. 

Version 1.3 Announcement Letter 

Version 1.4 Announcement Letter 


ICR Availability Notice for FBM and VSE/ICCF Support 


Version 1.4 Announcement for CMS Support 


Version 1.5 Announcement Letter 

Program Product Design Objectives 

Program Product Specifications 

Sales Flyer 

Sales Flyer 

Sales Flyer 

General Information Manuai 

Guide For New User | 

Application Programming Reference Manual 
Utilities and Guide for Systems Programmers 
System/Application Design Guide 

Operators Reference Manual, Messages and Codes 
Debugging Guide | 
Program Logic Manual I 

Program Logic Manual II (Microfiche) 

MPS Planning Guide 

1.3 Planning Guide 

DL/I DOS/VS 1.2 Performance Report produced by Endicott 
({ See Item 3 ) 
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CHAPTER 9 


DOS/VS DATA COMMUNICATICNS FUNCTION GROUP 


-~ CICs/DOS/VS (5746-xXX3) - 


Note : 


CICS/VS 1.4 RELEASE G 
WTSC Boeblingen Distr 


UIDE published in 
ibution BO-06-78, item 4, Aug. 15,1978, 


describes in detail the CICS/DOS/VS 1.4 new functions, use, 
APT, installation and SYSGEN. 
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9.1 INTRODUCTION 


This chapter presents a brief overview of the data 
communication product, CICS/DOS/VS. In particular 
CICS/DOS/VS Version 1 Release 4 is addressed. 


CICS DOS/YVS (5746-XX3) 


Status >: SPL program product 
Latest Release s “here 

System IPO/E Avaiiable : planned 3079 
Installation Licence >: NSA 
Pre-Installation Test >: 60 days 


9.1.1 PRODUCT FUNCTION 


CICS/VS iS a yeneral-purpose DB/DC interface between the 
operating system and the application programs written in ANS 
COBOL, PL/I or Assembler. The uSer can generate a CICS/VS 
system configuration applicable to the needs of the 
installation and to define the environment in which the 
system is to execute. User exits are provided within the 
CICS/VYS management module for optional processing as 
reguired for specific system operation. An interface 158 
provided to allow application programs to request CICS/VS 
facilities such as task and terminal management, formatting 
of data to terminals and interfaces to system service 
programs. 


Although CIcS itself provides a comprehensive file handling 
capability (sequential, direct, indexed and segmented), that 
is satisfactory for many applications, the Full capabilities 
of a data base/data communication system can be obtained by 
the use of DL/I with CICS/VS. This allows the CICS/VS user 
to take advantage of the data independence capabilities of 
DL/I. 


The operating system Supervisor and data management Services 
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are used by CICS wherever they are functionaily applicable. 
In the area of Security, cCICS/VS provides facilities to 
prevent unauthorized access to information. These security 
facilities can be extended by user programming, if required. 


By handling activities such as Storage management, file 
management, terminal management, task manayement and so on, 
CICS/VS removes the need for the programmer to concern 


himself With such activities or With the physical 
characteristics of terminals, line control protocols and so 
on, and to allow him to concentrate on developing 


applications to process tne transactions in a form suitable 
for his particular business, 


CICS/VS provides many of the facilities necessary for the 
generai data communication applications of inquiry, order 
entry, data entry, data collection, message switching, 
broadcastiny, order distribution and data base browsing 
together with the more specific type applications including 
credit authorization, point of sale applications and those 
applications of the store and forward type. 


The functions needed to support these applications are 
provided through the following CICS/VS logical components ; 


od system Management 
e System Service 
e System Monitoring 


* System Reliability 

® System Support and 

° Application Services. 

Each of these components contain one or more functions which 
provide Services to the user written application programs. 
Most Services are reguested directly by the application 


programs, but some are performed automatically by CICS/yVS to 
Support certain functions basic to a DE/YDC environment. 
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° The system management component contains: 
= Task management 
= Storage management 
= Time management 
= Terminal management 
a File management 
= Transient data managenent 
= Temporary Storage management 
= Journal management 


7 Sync point management 


» The system service component contains ; 
= Sign-on / sign-off 
ai Master terminal function 
= Supervisory terminal function 
= Operator terminal function 
= System statistics 
= Asynchronous transaction processing 
= Dynamic open / close 
a Time of day control 
= térninal test 


= Message Switching 


* The system monitoring component contains ;: 
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The 


The 


Trace management 


Dump management 


system reliability component contains 
System recovery management 

Dynamic transaction backout 

Transaction Restart 

Emergency restart 

Abnormal condition program 

Program error proyran 

Terminal / Node abnormal condition program 


Terminal / Node error program 


system Support component contains; 
System Generation 

Environment definition 

System initialisation 

System termination 

Program preparation 

Trace utility 

Dump utility 

Formatted dump program 


System log / journal utilities 
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application service component contains ; 

BaSic mapping support 

Execution diagnostic facility (command level) 

IBM 2260 compatibility 

Built-in functions 

Table search, Phonetic conversion, Field verify, 


Field edit, Bit manipulation,Inpur formatting and 
weiyhted retrieval. 
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Meet key uSer requirements: 
Shared Data Base 
Program Isolation 
Transaction Restart 


Increase user productivity: 
High level programming interface (HLPI) for Assembler and RPG II 
DL/I Call Enhancements 


Improve usability: 
Entry Level System (ELS) | 
Execution Diagnostic Facility (EDF) 
Object Code Compatibility 


Extend Function to strategic direction; 
Distributed data / processing through intersystem communication (ISC) 
SNA device support - 3270 IDS enhancements support 


DL/I DOS/VS 1.4 
ann. 6/78, fcs 12/78 
provides access to remote DL/I Data Base 
Call Enhancements 


DL/I Entry 
Call Enhancements - yes. 


RPG/VS R II 
HLPI 


All DL/I items related to CICS/OS/VS are part of 
the CICS/VS 1.4 base release. 


9.8 IBM Internal USe |  WTSC BOE 


DOS/VSE Planning Guide Chapter 9 .4 
4210-9826 Volume If Highlights 


INTERSYSTEM COMMUNICATION 


THE SYSTEMS 

CICS/YVS Inter-system communication support provides the 
Capability for two or more CICS/VS systems to communicate, 
whether running in the same or remote location or in the 
Same CPU. This 1S in addition to the ACF VTAM function 
allowing terminal logon and communication with any 
application in any host in a network, but provides 
communication on a tranSaction rather than Session basis. 
Communication may be between CICS/bDOS/SVS, between 
CICS/OS/VS, or between CICS/DOS/VS and CICS/OS/VS systems, 
through VTA. 

Inter-systen communication 1s not supported by 
CICS/DOS/VS-ELS. : 


THE CONNECTING LINK 

The CICS/VS systeas must be connected by an SGLC link which 
may be part of a SNA multi-system network supported by 
VTAM/NCP. However, the terminal network attached to the 
CPU's may consist of S/S, BSC or SNA terminals. The type of 
connection between CICS/VS systems 1S transparent to the 
CICS/VS application program. 


APPLICATION FACILITIES ACROSS THE LINE 

These extensions allow CICS/VS application programs to 
access files and databases on a connected system and allow 
CICS/VS transactions to route messages to another CICS/VS 
system. The data transmitted may initiate a transaction to 
process it on the connected system. The interface for the 
CICS/VS application projrammer is at the command level 
(EXEC), allowing existing applications uSing the EXEC 
interface to run unchanged, or with very little change apart 
from error handling, to use the inter-system connection 
environment. 


THE FUNCTIONS AVAILABLE TO THE APPLICATION PROGRAM 3; 

The function provided extends the current File Control, 
Transient Data, Temporary Storage, Interval Control 
Transaction Initiation (START, CANCEL) commands and IMSS DL/I 
reguests, to allow the requested file, database, queue 
transaction requested to be on an attached system. The 
definition of which system is to be uSed to satisfy a 
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particular request is held in CICS/VS table extensions and 
iS Specified by the installation system programmer. This is 
therefore transparent to the application projcraanmer, 
although applications may specifically select the particular 
system on which a particular command is to be executed. 
Existing EXEC transactions can run unchanged even though a 
File, database, or application program is saoved to another 
system, or the network reconfigured, since exactly the same 
application program interface is used to access both local 
and remote resources. 


Accesses to remote DL/I database managed by ODL/I LOS/VS is 
Supported. Access to remote DL/I database managed by DL/I 
DOS/VS is provided by BDL/I DOS/VS 1.4. 


CICS/VOS/VS ENTRY LEVEL SYSTEM 


REPLACES SUBSET OPTION ; 

CICS/LOS/YS-ELS replaces the ‘Subset Option’ that has been 
part of previous CICS/DOS/VS. While providing approximately 
the same functional capabilities the CICS/LOS/VS-ELS will be 
able to make Savinjs in both working set and path length. 


FUNCTIONS SUPPORTED °: 

Terminal support iS provided via BYAM or YTAK for 3270 
devices only attached locally or via remote leased lines. 
BMS Support for communication with online terminals provides 
device independence for application programs. Intrapartition 
transient data queues and in particular ATI are also 
supported. DL/I DOS/VS and DL/I Entry DOS/YS are supported 
together with ISAM and VSAM access methods. 


FUNCTIONAL LIMITATION : 

Since full recovery/restart facilities are not supported 
through ELS, it 18S recommended that the use of DL/I he 
limited to online inguiry, with batch update. Users wishing 
to update online are recommended to use full CicsybDOoOS/VS. 


EASE OF INSTALLATION AND MIGRATICN 3; 

No system generation is reguired to instail ELS, although 
some table generation will still be necessary. Only the 
command-level (EXEC) interface is available to the 
application programmer. Application programs may be written 
in PL/I, COBOL, RPG or ASsSenbler. The migration to full 
CICS/DOS/VS is simplified since application programs, maps 
and tables will be object compatible with full CICS ,/DOS/VS. 
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USABILITY ENHANCEMENTS 


Programming Languaye Support 


ASSEMBLER AND RPG HLPI (EXEC) 

In CICS/VS 1.3.0 the HLPI was introduced for PL/I and COBOL 
application programs. This removed the need for application 
programmer to understand and manipulate CICS/VS internal 
control blocks and to perform CICS/VS internal storage 
Managements operations. The isolation of the application 
programmer from the CICS/VS control block logic teduces the 
possibility of inadvertent errors giving therefore a higher 
degree of protection. The HLPI helps to increase progtammer 
productivity and reduces the probability of coding errors. 


This facility will be extended in CICS/VS V1 R4.0 to provide 
a Similar interface for Assembler and RPG application 
programs. The RPG ainterface Supports the DOS/VS RPG ITI 
compiler (5746-RG1)rel.2. 


COMBAND LEVEL INTERFACE RESTRICTIONS: 


Following Functions are NOT supported by the command level 
APT 


* Built-in functions (except for de-edit) 

* Indirect accessing of files 

* Certain system programmer functions such as 
Task control Attach and Purge. 


NOTE : 
* Segmented files are how Supported by command level. 


ENHANCED DL/I CALL INTERFACE 


CICS/OS/VS AND CICS/DOS/VS 

CICS/VS application programs requiring access toa ODL/I 
database today have a high level interface available in the 
form of DL/I CALLS. This still requires the application 
programmer to obtain the response by examining CICS/VS 
internal control blocks. CICS/VS V1 84.0 enhances’ the 
interface by Tremoving this reguirement. This enhancement 
for DOS/VS requires DL/I DOS/SVS 1.4 (FCS 12/78). 
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EXECUTION DIAGNOSTIC FACILITY 


INTERACTIVE PROGRAM TESTING AND DEBUGGING :  s | 
This facility enables a CICS/VS application. programmer to 
test an application written using the EXEC commands in an 
online interactive manner. It intercepts application EXEC 
commands, immediately before and after their execution, as 
well aS transaction initialization and termination. This 
enables the user to step through the CICS/VS commands in the 
application checking their validity. The user is also 
allowed to make temporary modifications to argument values 
and response aS required. No translated or other specially 
prepared form of the application program is required. 
Information will be displayed ona 3270 terminal (with a 
screen size of at least 1920 characters) which may be the 
terminal being used to run the application under test. Thus 
the application programmer needs only one terminal to run 
the new transaction and to interact with EXEC Debug 
Facility. 


[The necessity for printing a transaction dump to debug an 
application under development is thus considerably reduced. 


PROGRAM ISOLATION 


CICS/DOS/VS : 

For CICS/DOS/VS DL/I DOS/VS user the program isolation 
scheduling 1S provided by DL/I bdDOS/YVS V1 R320. and 
subseyguent releases. 


TRANSACTION RESTART 

This facility enables the user to specify those transactions 
which should be immediately restarted if they have been 
abnormally terminated and backed out by the CICS/VS Dynamic 
Transaction Backout facility. In particular this facility is 
useful for transactionS which have been abnormally 
terminated because of Program Isolation scheduling deadlock, 
although ait is not restricted to this type of ABEND. 
Wherever possible, the terminal operator will be unaware of 
the ABEND, back out and restart of the transaction. 


3270 ENHANCEMENTS SUPPORT 
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FEATURES SUPPORTED ; 

Current CICS/VS support for the 3270 Information Display 
System is extended in cCICS/VS V1 R4.0 by the following 
enhancements: larger screen sizes than those available on 
previous 3270 displays; additional Program Function Keys; 
Program Attention key on the SCS printer; a print 
authorization tatrix and a magnetic stripe reader. 


SCREEN SIZES : 

Models 1, 3 and 4 of the 3270 displays have a choice of two 
screen sizes. CICS/VS V1 R4.0 supports the use of either 
screen size ona transaction basis. For every model, one 
screen 51ze coincides with current 3270 screen sizes, thus 
providing compatibility for existing 3270 applications. 


ADDITIONAL PF KEYS ; 

The enhancementS provide additional program function 
keys 13 through 24 as a feature. CICS/VS V1 R&.0 allows 
these to be used as transaction identifiers and BMS paging 
commands, or Will pass them through to a CICS/VS application 
program when received. Thus an application program and its 
end users may aSSign a particular meaning toa progratn 
function key with CICS/VS acting only as the message medium. 


3770PC SUPPORT 


FULL FUNCTION LOGICAL UNIT 

CICS/VS SNA support for the 3770PC Oniine Programmable 
Communications Terminal is extended to assist users to code 
3770PC programs to communicate directly using read and write 
macros in a Similar manner to 3790 FP's for full function 
logical unit. This reguires no change to the existing 3770PC 
Support in CICS/VS. CICS/VS publications will be updated to 
outline the sequences used by CICSy/VS and a sample program 
wiil be provided. 


DASD DEVICE SUPPORT ENHANCEMENTS 


VSAM FOR INTRA-PARTITION YRANSITENT DATA ; 

CICS/VS V1 R4.0 enhancements will offer improved use of DASD 
devices. YThese enhancements allow the optional use of VSAM 
aS the access method for [Intrapartition Iransient Data, 
jJiving enhanced performance by reducing the number of 
physical I/Os compared with the existing BDAM Support. 
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SAM FOR RESTART DATASET : 

This allows the Restart bataset to be managed sequentially 
via SAM instead of DAM, allowing faster CICS/VS 
initialization. 


3350 DASD :; 

CICS/DOS/VS users may also specify 3350 in certain 
device-related parameters for CICSYVS generation; this 
complements functional (transparent) support introduced with 
CICS/VS V1 R3.0 for 3350 and 3330 model 11.) 


COMPATIBILITY 


SOURCE COMPATIBILITY : 

CIcs/yvVS V1 R4.0 will be source compatible with previous 
releases of Version 1 at application program interface 
(Macro or Command level). This means that application 
programs need, at most, be re-assembled or re-compiled to 
operate with Version 1 Release 4.0. 


OBJECT COMPATIBILITY : 

Object compatibility is guaranteed to applications 
written to the Command Level Interface as defined in the 
APRM-CL (SC33-0077). In addition there will be object 
compatibility between V1 R4.0 and V1 R&3.0 at the level of 
macros and control blocks as described in the APRM-ML 
(SC33-0079). Object code compatibility cannot be assured for 
those programs that use facilities other than those 
described in the above manuals. 
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9.5.1 CURRENCY 


CICS/VS 1.2 : 
All releases of CICS/VS Version 1 up to the Release 2.0 are 
no longer current. 


CICSIVS Ve3 3 

Version 1 Release 3.0 waS available 28 February 1977 
for cICS/DOS/VS and 29» April 1977 for CIcS/OS/VS. This 
celease will be current until 13 months (LOS) and 12 months 
(OS) after the availability of the respective CICS/VS ¥1 
R4Y.0. It will therefore be current until 31 August 1979 for 
CICS/DOS/VS, and 30 October 1979 for CICS/OS/VS. 


APAR SSRVICE FOR CICS/YS 1.3 : 

This means that corrective (APAR) service will be 
provided for cICS/VS ¥1 R3.0 until the expiration of the 
currency periods as defined above. Preventive (PTF) Service 
will be available for the CICS/VS V1 R3.0 up to the 
availability of CICS/VS V1 R4.0 (i.e. 30 June 1978 for 
CICS/DOS/SVS and 30 September 1978 for CICS/OS/YS). 


9-2-2 CICS/ZVOSZVS PROGRAMMING SYSTEMS 
The following table shows, for users of VTAM, EXTM or BTAM, 
the LOS/SVS Release under which CICS/COS/SVS will 


operate.Release numbers are provided where appropriate. 


CICSZDOSZVS DOS/VS 

33 34 
1.3.0 BAM Xx x 
1.3.0 VTAM x x 
1.3.0 EXT 341 361 
1.3.0 ACE/VTAMN 4 
1.4.0 BTAM A 
1.4.0 VTA a 
1.4.0 EXTER 3.1 
1.4.0 ACF/VTAM x 

Notes; 
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ICS/DOS/VS VTAM and ACF/VTAM Support IBM 


3270, 3600, 3650,3767,3770,3774/5 Programmable and 3790 
(configuration support 9165,9169 and 9431) 


IcS/VS 1.4 with VTAM-Supported logical units freyjuires 
the ACF/VTAN PP (5746-RC3). cicsyvVS 1.4 [SC facilities, 
other than for communications within the same CPU, 
reguire Multi-System Networking Facility feature of 
ACF/VTAN. 


ICS/DOS/VS ELS does not support EXTM. 


DOS PL/1 version 1 release 5.0 muSt be installed to use 
the EXECUTE interface. 


COBOL v3 or DOS/VS COBOL must be installed to use the 
EXECUTE interface. 


To use the optional CICS/DOS/VS interface to Data 
Language/I (DL/I), the user must have installed either 
the DL/I DOS/VS (5746-xx1) or the DL/I-Entry DOS/VS 
(5746-xx7) Program Product. The following indicates the 
releases of DL/I DOS/VS and DL/I-ENTRY DOSyVS that run 
With CICS/YS. 


CICS/DOS/SVS DL/1-E DOS/SVS DL/I DOS/VS 
1~e360 220 Vecl@ Mae bend 
1.4.0 220 135% Jat 
Notes: 


nee enthin alate cane annie 


1. DL/I Entry DOS/YS does not Support access to a 
remote database thtough CIcCSyDOS/VS inter-system 
communication. DL/I LOS/VS 1.4 supports access to 
remote database. 


2eCICS/VS device support through VTAM, or (for SNA 


devices only) through EXTM, requires the COMPARE 
AND SWAP instruction on the host CPU. 
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COMM. MAG. 
CARD SELECT.] 5S 
SYSTEM/7 | B 
CPT-TWX 33/35 5S 
WORLD TRADE | 

TELEX 1 Ss 


| 
| TERMINAL | BAM 
Geceaeen eee [pees 
START/STOP | 
1050 } B 
2260-1,2 | NS 
22635-1,2 1 NS 
2740-1 } 8B 
2740-2 } NS 
2741 | 5B 
3767-1,2,3 | 8B 
9100 | B 
| 
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EXIM VIAN REMARKS 
NS 
NS 
NS 
Supported as a 2741 


Supported as a 2741. 


Program Controlled 
Disconnection Supported. 
SSeS SSeS Se SSeS ~~--contd. 
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Terminal Support (continued) 
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3741-2,4 


3770 

3780 
SYSTEM/32 
SYSTEM /34 
SYSTEM/6 
SYSTEM /3 
SYSTEM/7 
SYSTEM /360 
SYSTEM /370 


a <ume Ee ED cD ee 


mu wu 


mo wom oo te 


wr <a a a 


—_ =e ea a <a: SE =a ani amelie Se oN 


Supported as a 2770 
Supported as SYSTEK/3 
Supported as a 2770. 


l l 
EXTM |] VTAM J REMARKS 
om nee ee mane aan ween [SSeS S| SSeS Se See SSS SS SS ee See 

l | 

NS | | 

NS | |] 6 Bit Transcode NOT supported. 
| | 

NS | NS | 3288-2 supported as 3286-2 

NS sf NS | 

NS | NS | 

NS | NS] 
i | RPG 8K0598 reguired. 3614 
l ] supported only if attached to 
{ j} a 3601/7306002. 
| | 
| | "8 
| ] With Terminal Identification 
| | Feature (7850) only SWITCHED 
| | lines supported. With Expand. 
| | Comm/Mulitipoint Data Link 
| { Control (1685) only 
i | NON-SWITCHED lines supported. 

NS | | 

NS | | 
| | 
| { 
| { 
| { 
i | 
| i 
| | 
| 
i | 
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Terminal Support (continued) 


a ND ai ate ae wn a Sah omen i cane oOmP wenn nie <a cate 


| | | 
|} TERMINAL | BAM | EXIM |] VTA | REMARKS | 
ee re ho ee (ee ae [oo ee aa aaa | 
| SDLC | | ; | | 
| Bani ae | | | | i 
|} 3600 | 1 x | XxX {| EXTM does NOT support :; | 
| | | | | 3601-2A,2B,3A,3B | 
i | } | | 3604-3,4,5,6 OR 3610-4 | 
|} 3630 | } xX } xX | Supported as 3600 | 
} 3650 | | xX | x | | 
} 3790 | | xX } x { 3790 Gata Entry with 3760 NOT | 
| | | | | Supported. 9165 Configuration | 
| | | | | IS required to support CICS/VS] 
| | | | | 1.3 enhancements. EXTM 3.17.0 |] 
| | | | {| WILL Support 9165 Config. | 
| 3707-1,2;,3 | |] xX 1 Xx | | 
} 3776 | }] xX |} xX | bata transfer func supported | 
{| 3271-11,12 | | xX | x | | 
| 3274-1c | | xX | xX | | 
} 3275-11,12 | | xX | | | 
| 3270-11,12, | } Xx | xX | | 
| 13,74 | | Xx | & l I 
| SYSTEMN/32 | | | X } Supported as a 3770. | 
| SYSTEM /34 | | ae. j Supported as a 3770. | 
| SYSTEN/370 | ] | | Intersysten communication only] 
} IBM 4300 { ] | <x | Intersysten communication only] 
[eee nese [eeenee = ‘aaa De ee ne ene eee eae | 
Pp ee Sa [Paaaes [eeeeas ere rere ree aer | 
|} LOCAL ATTACH | | | | | 
| ==s=>===>>== j | | | 
| 2260-1,2 | x | | | | 
| 3272-1,2 i Xx | | x | | 
{ 3272-1b } x | | xX | | 
{| 3274-1a | {| xX [| xX | | 
} 3790 i ] x } x | See remarks for SDLC 3790 | 
| 7770 | & ] ; | | 
aaa rca ac ac asa aac per Pi ree ge Te glee we pee ee ad eee | 
NOTES. NS = NON-SWITCHED 

9 = SWITCHED 

6 = BOTH SWITCHED and NON-SWITCHED 

X = Supported 


CICS/DOS/VS Entry Level System does not Support EXTM 
ACF/VTAM (DOS/VS) PP 5746-RC3 is required to support CICS VTAM 
functions. 

MSNF reature is also required for de tem communication with 
another processor. 
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9-7 CiIcs DbOS/VS 4.4 TERMINAL/COMMUNICATIONS CONTROLLER 

SUPPORT , 

(Se ee te ee ee ee pe Ae Pe ere eae eer PO gene | 
| | TCU / COMMUNICATIONS CONTROLLER | 
eee ee ee eee ae ee ene ee | 
IS/S TERMINAL | 2701 | 2703 jIca/115, 125, 135, 13843704705] 4300/CA] 
Ce ee err ae a ee ita) al a a a aa a cae gia) acca aaa 
11050 i X l x ] X | x | X 
{2260-1,2 , xX | | ICA/135 ONLY | xX | 
12265-1,2 ; x | | ICA/135 ONLY | x | 
{2740-1 | X | ¥ | X | X | X 
{2740-2 | X | x i xX } x { X 
}2741 | X | X | x | xX | X 
13767-1,2,3 | xX | } X ] xX | X 
J}COMM. MAG. | | | | | | 

{CARD SELECT. | X ] X | x | X | 
ISYSTEM/7 | X i X | xX | X j 

45100 © | x | X i xX | > 4 1 x 
{CPT-TWX 33/35 | X | X { X | X ; 
| WORLD TRADE { | ee | J | 

{TELEX | X i x | X | ¥ | 
jeacsosteveeees] ae SS eer eo ee ee ee |-------]Contd.~| 

Note : 


1. “IBM 4300 / CA : Only terminals uSthg the IBM Terminal control 
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TCU / COMMUNTCATIOCNS CONTROLLER | 


rae <a ewe sen <i wee aE -CNP WannA cae ED can) en “DED -CERD cE mtn <a wae -cte OG Run conn ctl AA a aa com nm En < o-—E ‘—ar «me cap wee ame em i a ae 2 mn wie ee 


}i1ca/i15,125,135, bid a dean Aad lees hota 


PS P< 


PS PS PS SG PS Od OS 


13276-1,4 
13651-A50, B50 
|3651-A60, B60 
| 3660 

13735 
13741-2,4 
{3747 

13770 

13780 

{SYSTEM /32 
[SYSTEM/34 
[SYSTEM /6 
ISYSTEM /3 
ISYSTEM/7 
SYSTEM /370 
JIBM 4300 

| ‘ss in: in Sai <i bah wise’ * is ais ei oS ea 
|SDLC TERMINAL 
13271-11,12 
}3274-1C 
13275-11,12 
(3276-11 to 14 
13600 

13650 
13767-1,2,3 
13770 

13790 

| SYSTEM/ 32 
137047 05 

{IBM 4300 

| sme ewe Ween sits ene son ome mame ame eum wee wee cee ame 


Pd Pd bd bd DS 


PS PS PS PN DS PG OG OS OS DS DC DS 

Pa OS DS 
PY od bd Od bd PS De OP bd PG bd BS Od 
i 


Pd DS PS PS PS DS BS DX 


— ee ee eee oe ee ae —E Pe ee ee ee We 6CUP OP GP UP CUP > ee ee ee ae <2 mb wee ee ee ae ‘on (bh oh ah wh ~sR amm 


aan 


or 
re 


(2) 


Dime wee we ti came mee 


tueeet Sieeete «ee reed «seek eae «eed ene eet «ened oc («oe «ogee «6d ie 0 henide sche deen oso els osbhieee eee ieee shew a ame anes @iatts meee cet cee wee at eee eee gee Geet eee ase 


—— < «em we ~eNP come ~<a EP a a AEP ~<a a oe atta CAI GRD Valitse 9QED CUNO CENY ORD TE CE WD ON wate SEE ante <a Came > a ~~ <a ve ae oD 


Notes : IBM 4300 Communications Adapter 15 supported as 


(1). a secondary station in ACF/VTAM environment. 
(2). a primary or a secondary station in an SNA Network. 
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9.8 CICS/DOS/VS 1.4 DEPENDENCY [INFORMATION CHART 


END Waites wnat SRE ASOD eae OTS TEC BED AIREY 4 Mma! 


oe prevequisi tas 

{| - DOS/VS EXTM | SDLC Terminals require VTAM or the EXTM feature 
} (5746-XXB) of CICS/DOS/¥YS 

| VEAM function require the installation of ACF/VTAM |] 
| (DOS/VS) PP 5746-RC3. Additionally, the Intersysten | 
{| communication facility, other than for communication] 
| within the same CPU requires the MSNF Ecotere Eee). 
{Program Facilities Support 

| - ASSEMBLER | Now supported via HLPI also. 

{| ~- COBOL/SVS j for HLPI COBOL V3 or DOS/YVS COBOL is prerequisite. 

- PL/I OPTIM. | For HLPI use DFHPL1I1I supplied by PL/I Opt. rel 5. 

] Module supplied in CIVS private rel 1ib is called 

| DFHPL1IS and may be renamed and used if HLPI 
| 
| 
| 
| 


en sieht emsty 


~ VTA" 


eae 
eh 


is not used. 


eee ame deems Geel ceenkis chine Geb dteekb 3h 


PP ap a> <~ sah wae WEP Ree = em com CED wee rem <p 


| Data Management Support 


—_ ee ee ee See ee ee ee TS hr re lr hr hr ine en «Ole SED meus NEE wb <ieme -ap COU We cam Ge SE A Cee ee ee OD we tn ee ee oe ee a a 


i 
| - VSAR | See VSAM Support table earlier. | 
| - SAM | Supported as CICS/VS Extrapartition Data Set. | 
| - DAM {| Blocked DAM record support. i 
|} - ISAM l | | 
| - DL/I } DL/I 1.4 required for extended CALL interface. | 
| - SEGMENTED | Special CICS/VS unigue organization. | 
|} - INDIRECT 1 CICS unique support for DAM,ISAM and VSAH. 

| 


Ta SSS SSS SSS ea a eS SS SSS SS SS See Sa Contd. 
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aecugenaciia aioe Geen a seen er | 
junit Record SUPPpCots Any DOS/VS supported L/o device. | 
saa SeHOrE 

2314 


ea 


| 
|} - 3333 
| 
| 
| 


wm them seep oem chee ane eee eee eee 


ee ER EN were CERI Nee ie wr GOR wot sete mE cae aR ORD inh coi OM me dee ORLY SAND COED SUED ED “OED SOR ED GRUP RED SS =O GERD WES WER GU SEE WED CENTS SUD WH CUP VED WE ee me <et ue we ae <a a sem 


GRRE 


ifape support 

| ete cae see te aie seth cata um cane wane cm mene nese wou oe 
{Current Release 
| ae 


a 
— 
be 
v1 
S&S 
SS 
rS 
#) 
ry 
fos a 
ce 
fou 
8 
© 
we 
~ 
“eS 
u 
‘as a 
pe) 
mS 
49 
fds 
(D 
wd 
jt 
CO 
3) 
r 


> A CED OED RIG ORR Re CE NEE cen WO OU ERD RTD AER CU EN OD rue “EU OID ONE OED ED ERIS “Ea WD ERY pen OU > OE WER 20S COND NUD lie Ce “ie aD a CR SED aE ee <a ee eee ee eee 


l 
{ 
| 
| 
| 
| 
| 

- 3344 | 

| . | 
| 
| 
| 
| 
|] Current 
| 


| 
Current until August 31, 1979. | 
i 


[Compatibility Information | 
l | (1) EXTM 3.1.0 users MUST use CICS DOS/VS 1.3, J 
| | DOS/YS Rel 33 or above, and NCP/SVS 5.0 {or 3 | 
| | ACF/SNCP/VS when available). | 
| | (12) See MIGRATION section as further peer eat ten: | 
[eco fy a erence | 
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3-2 PROGRAMS INTERFACING WITH CICS/DOSZVS 


— y zs sm 


the following programs can be used in conjunction with 
CIosy/yvVS to facilitate the installation and development of an 
online systen. 


ETSS IL (5798-CLR) 

EXTM (57486-XXB) 

DMS DOS/VS (5746-XC2) 

Chained File - DL/I Bridge (5748-xXX3) 

CICS SPMOL-II (5798-CFT) 

CICS Performance AnalySer-IT (5798-CFP) 
CICS Dynamic Map (5798-AXR) 

CICSPLOT (5798-CCG) 

CICS Network Activity Simulator (5798-CCH) 
CicS Forward Recovery (5798-CJF) 

CICS 3270 Simulator (5798-AXC) > 

CICS Online Test/bebug-II (5798-AHJ) 
CICS/HECS Screen Format Utility (5798-CBH) 
CiIcsS COBOL Call Interface (5798-AHK) 

CICS Bill of Material (5798-CKP) 


In addition the following application systems require CICS 
bCOS/VS for data communications support. 


ATNS-II DOS/VS (5746-XXG) 
STAIRS DOS/VS (5746-XR4) 
RIRMS DOS/VS (5740-XR1) 
PLANCODE/I DOS/VS (5746-XX9) 
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9-10 PERFORMANCE FACTORS SUMMARY 


The purpose of this section is to provide a checklist type 
overview of some of the important factors influencing 
performance of CICS/VS systems. 


The user should refer to the cCICS/VS System Programmers 
Guide and the CICS/VS System Programmers Reference Manual 
for detailed discussion of some of the individual 
parameters. 


Good or poor performance may be judged in many different 
ways, dependent on the environment. However typical criteria 
for the level of performance are ; 

(a) System Throughput 

(b) Response Time 

(c) CPU Utilization 

(ad) Storage Utilization 


Performance factors can be divided into two major groups 3; 


(a) Those that affect process time i.e. CPU process 
time and paging rate influence on process time. 


(Db) Those that affect wait time i.e. Wait time due to 
un-overlapped I/O and time due to tasks being 
‘'gueved! waiting for execution, 


The following list documents the factors in each group : 


(a) CPU process time. 


DOS Factors - Job Accounting 
- Fast CCW Translate for high activity VSAM files 
CICS/YS Services - Trace 
—- Dump 
- Automatic Statistics 


CLICS/VS Access Method - BTAM wrapiist,general poll,negative 
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poll delay 
- VYTAM Definite Response,Immediate I/O, 
Message Integrity 


CICS/VS Management - Number,size and sequence of tables and entries 


CICS/VS Integrity - Use of logging and and protection of 
Temporary Storage, Transient Data, Fiie Control 


I/O Blocking - Locate/move mode 


Application Functions - Terminal control BMS 
- File control browsing 
- Getmain/initialization image. 
- Program calling strategy - linking or XCTL 
- Error recovery 


Data Base Support - DL/I call processing 


(b) Paging Rate Influence on Process Time 


CICS/VS Batch Contention 
TP Balancing 
Storage over-commitment 
Conversational transactions 
Automatic Journalling 
Anticipatory paging 
Level of CICS/VS multi-tasking (MXT,AMXT parameters) 
Transaction Rate 
Resident Programs 
Nucleous Load Table (NLT) 
Dynamic File Open 
Storage Cushion Size 
Trace fable size 
VSAM - Number of strings, buffers 
- Local Shared Resources 
- Number of index levels 
DL/I buffer pool — number of subpools and buffers 
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(a) Un-overlapped I/O (between partitions and within CICS/VS 
partition across tasks) 


Paging I/0 

Synchronous tape and disk I/0 
CICS/VS Protected Resource logging 
Auxilliary Trace 

ISAM non-resident index 

ISAM overflew records 


(b) "Queued’ Wait Time (at the task level) 


Application Exclusive Resource Control 
- VSAM file control 
- DL/I PSB 
~ Transient data 
~ Temporary storage 
- VTAM mesSage integrity 


System/Network 
-~ Channel queues 
- DOS/SVS transients 
- VSAM strings 
- DL/I Maximum TaSkS parameter (MXT) 
- CICS/VS Maximum Tasks parameter (MXT) 
- Short On Storage (SOS) condition in CICS/VS. 
- VYTAM Receive Any Pool 
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9-11 SISCELLANEQUS ENHANCEMENTS 


SUMMARY | 
Following is a list of miscellaneous enhancements in CICS/VS 
1.4 


CICS/DOS/VS and CICS/OS/VS ; 


Good Morning message 

{Transient Data Queue improvements 
Dynamic Open of VTAM ACB 
Initialisation [Improvements 
Character field edit in HLPI 

3790 Keyed Messages Support 
Problem Determination Improvements 
Improved dump data placement and packaging 
USability and tuning enhancements 
Simplified table generation 
SYNCPOINT ROLLBACK 


CICS/DOS/VS only : 
High Level Programming Interface for RPG IT 
Access to remote Database 


DL/I DOS/VYS call enhancements 
Tunable Short wait 
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CICS/DOS/VS AND CICS/OS/VS 


9.11.1 GOOD MORNING MESSAGE 

A "Good Morning" message may be sent to any VTAM LU after 
the LU logs on to CICS/VS. The message may be specified by 
the user. For the IBM 3270 display terminals a CICS/VS logo 
(like VM/37U) 1s generated. The ‘Good Morniny’ message is 
displayed on the bottom line below the logo. The text of the 
message is specified by the user in the DFHTCT TYPE=INITIAL 
macro. 


DFHTCT TYPE=INITIAL, 
ACCMETH= (VTAM,.-) , 
APPLID=..., 
GMEPEXT='Hello! CICS is now online.' 


The good morning message is sent after VTIAM logon by LU to 
CICS/VS. The message is Sent by the transaction CSGM, which 
is invoked in the OPENDST exit for the LU. 


An option in the terminal entry specifies if the message is 
to be sent to the LU. 


DFHETCT TYPE=TERMINAL, 
ACCMETH=VTAM, 
GMMSG=NO | YES, NOC is the default. 


sas 2 


9.11.2 TRANSIENT DATA QUEUE VSAM OPTION 

Optionally VSAM May be uSed aS the access nethod for the 
Intra-partition Transient Data queue management. This is 
instead of the current DAM support which is the default. For 
most users this means a significant reduction in the number 
of f[/0 operations and the associated disk I/O and CPU 
instruction overhead. 


The VSAM option is specified in the TDP program 
DFHSG PROGRAM=TDP,INTRA=NO|DAMIVSAM,... 


There iS a device option cor DAM in DFHDCT TYPE=INITIAL. 
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9.11.3 DYNAMIC OPEN OF YTAB ACB 

VIAM may be started after CICS has been activated. However 
VTAM may not be terminated prior to shutdown of CICS/VS. 
Instead of at the time of CICVYS initialisation, master 
terminal operator can initiate a deferred open of VTAM ACB. 


9.11.4 INITIALISATION IMPROVEMENTS 

This permits high flexibility in system operation. All the 
parameters that can be specified in the Systems 
Initialisation Table (SIT) may also be entered as overrides 
at initialisation time. Overrides may be entered via the 
console or the SYSIN device. 


EXEC=YES can be specified in SIT or overrides. There is no 
need for a PPT entry for DFHEIP program. It is loaded as a 
part of the CICS nucleus. 


PRINT=PAn, Specifies the 3277 print key Support in SIT or 
override. 


SKRxXxxx='paye-retrieval-command', xxxx iS any PA/PF key. 


9.11.5 


This CI 1S now available in HLPI. 


The DEEDIT built-in function of the macro interface is now 
also available via HLPI. 


This is particularly convenient for RPG programs needing the 
function equivalent to the PL/I and COBOL picture function. 


Also segmented file support in local cCIcS system 15 
available in the Command Level. 


9.30 IBM Internal Use WISC BOE 


DOS/VSE Planning Guide Chapter 9 .11 
2210-9826 Yolume II Misc. Enhancements 


9.11.0 3790 KEYED NESSAGE SUPPORT 

3790 (EC52) extends the capability to retrieve messages by 
key / identifier rather than sequentially. The route list 
fields for 3790 have been extended to allow specification of 
3790 keyed messages through the use of the LDC fields. 

This support is available in the user route lists or on CMSG 
requests. 


Currently certain types of Storages are freed during 
transaction processing. AS a problem determination aid, 
these areas are optionally frozen and only freed at the end 
of the transaction. Then ABEND and other Dumps contain all 
the storages relevant to the transaction. 


The storage freeze is activated/fdeactivated by the trans. 
CSFE. 


CSPE DEBUG TRANID=... | TASKREyY=... STGFRZ=CN | OFF 


TRANID or TASKREQ aS specified in PCT ( PA/PF keys) but not 
LPA or OPTD. 
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Suspension Timeout of tasks 

This is the deadlock or suspension time out that may be 
caused for example due to ENO ona busy Lresource, Temporary 
Storage full,SOS etc. The abend code is AKCT , like that for 
terminal read timeout. 


DFHPCT TRANSID=...,DTIMOUT=...,RTIMOUT=...,7... 


A timing trace entry is added. This entry is created 
automatically approximately every 128 trace entries. This 
enables the correlation of various subsystem traces and 
dumps (for example CICS and ViTAM). 

More trace entries are now decoded. Program Debugging Guide 
gives more informatin on this. 


A new subfield in the trace entry identifies the request 
type (for eg. user, FE or LIFO module). 


Additional trace entries generated by the management 
modules using the LIFO storage scheme, indicate the 
beginning and the completion of the request to the module. 


On an ABEND or program check processing in the System 
Recovery Program a new trace entry iS made. 


9.11.8 DUMP DATA PLACEMENT AND PACKAGING 

The CICS Transaction Dump and Formatted Dump facilities now 
direct their output to the Same data Set. Moreover variable 
length record format iS used to reduce the dump data set 
Space requirements. 


Tne dump datasets DFHDMPA / B can be uSed in any order. 


The dump utility program prints dumps on both datasets. 
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Logofi by VIAN LU 

On a ‘logoff! from CICS/VS by a VTAMN LU the LU status is 
left unchanyed. This means that the LU can logon again to 
CICS/VYS without intervention ftroa the master terminal 
operator. 


The LU is not set to RECEIVE status. 


Format of sign off is : 
CSSF LOGOFF 


[his applies to BTAM switched line connections. This type of 
logoff causes a DFHTC TYPE=DISCCNNECT to be issued by CICS. 
The switched line connection is disconnected. Some uSers may 
have already written transactions to do such a disconnect. 


This is now available to all VTAM LU's instead of only 
3270's. 


END statement in TABLE yeneration 


It is no longer mandatory to specify the entry point name on 
the END statement. 


Conditional ENQ 
Transactions have now the option not to lose control when 
the requested resource is already in use. 
DFPHKC TYPE=ENQ, QARGADDR=...,COND=YESINO default is NO 
EXEC CICS HANDLE CONDITION ENQBUSY (label) ... 


BAEC CICS ENO wa 
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EIB support for BSC Devices 

ETB (end of transmission plock), is now Supported on certain 
BSC devices (like 2770,2780). BSC Devices Which can 
differentiate petween ETB and ETX (end of tranSmission text) 
can obtain performance improvements by the use of ETB. 


Journai STARTIO option 

In the Journal Control Table a new option specifies whether 
Start I/O is to be forced or not. NOTE that the default is 
to force start I/o. 


PCT / PPT GROUP STATEMENT 


The GROUP Statement generates a complete set of transaction 
Or prog. entries in PCT and PPT, with all their attributes 
Suitabiy defaulted. 


DFHPCT / DFHPPT TYPE=GROUP, 
FN=STANDARDIISC[EDF|VTIAM|VTAMPRT]FE|]CONSOLE| TIME 
ATPJ|AKP|AUTCSTAT|MSWITCH] BMS] HARDCOPY] MASTTERM 
JOURNAL|SOGNON]... 


INDEX CPTION 


The INDEX option repiaces the ‘page index' option for the 
PCT, PPT and GC. It provides an efficient access to large 
tables and removes the uSer responsibility to sort tables 
into alphabetic order. Entries can now be sequenced for 
efficiency and or convenience. 
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9.11.10 SY¥NCPOINT ROLLBACK 

Rollback is an extension to Ssyncpoint facility. Application 
program can use this to request the cancellation of the 
Changes it has made to all recoverable tesources . These 
resources are restored by CICS to the state they were in at 
the previous Syncpoint or task initiation. 


The facility is available to the appiication programmer in 
the Macro level and Command level. 


DFHSP TYPE=ROLLBACK,... 


EXEC CICS SYNCPOINT ROLLBACK,...« 


(9-11.11 ISC MESSAGE SWITCHING SAMPLE APPLICATION 

This sample application is supplied with CicsyVS, and helps 
to illustrate / verify the ISC function in the installation. 
It can send a message from a terminal operator in one CICS 
system in the network to a specified destination in another 
CICS system in the network. The msg 1S sent on the ISC link 
and uses the ISC function of CICS/VS 1.4. The application is 
coded in PL/I and uses the command level interface. The 
receiving destination may be a ternminal. 


More information is given in the installation documentation. 


9.11.12 CICS/DOS/VS ONLY 

HLPI for RPG If 

ACcess to remote DL/I Database using DL/I DOS/VS. The 
Database may be a DL/TI DOS/SVS or IMS/VS-DL/I Database. 

DL/I DOS/VS Call Enhancements 


Tunable Short Wait 

User can now override the default wait time used by 
CICS/DOS/VS to regain control from DOS/VS to check for the 
completion of disk I/C events. This SIT operand ICVSWT can 
be overridden at start-up time. 
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9.11.13 COMPATIBILITY 7 
CICS/VS 1.4 is source compatible with previous releases of 
V1 at the API Macro or Command level, with the following 
exceptions ; 


The TIOA prefix parameter is now valid for Assembler 
programs. Previously this parameter was ignored. 


Object level compatibility 1S assured to command level 
prograas. | 


Additionally object level compatibiiity exists for macro 


level programs between 1.3 and 1.4 at he level of macros 
and control blocks as described in the APRM Macro Level. 
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Volune II Supervisor Options 


9.12 DOSZVS SUPERVISOR GENERATION CPTIONS 


The foliowing 1S a breakdown of the mandatory and suggested 
Supervisor parameters 


macros ¢ 


| ca eat asada: “one eae 
| MACRO 


> a wr we ‘ei ane 


uth ques Geet att wee gees een ee sel see eee gee tee eee eee ae ae ee ee ewe eee ae eet oe see eetet eee Ge 


WESC BOE 


within the Supervisor generation 


PARAMETER | 


a a Wi dame ai atte came Cm aim onl cajem wien “EE walt cum 


oncom 


NPARTS=2+ 
PAGEIN=n 
TP=a/mnethod 


SPARM=YES 
BDECK=YES 
ALIGN=YES 


sate << Ce wD bit we <a eee wee <a ee me <a <a aoe 


saunas 
Multitasking - for ATTACH macro use. Required 
for multitasking if journalling or asynchron— 
ous loader is used,or if TP=VIAM is specified. 
AP=YES forces WAITM=YES in FOPT macro 
At least 2 partitions must be specified 
Must be greater/equal to 1. 
BTAM ocr VTAM or (BTAM,VTAM) 
Specification of TP=VTAM forces following 
parameters for FOPT : 
AB=YES 
OC=YES 
PC=YES 
IT=YES 
TOD=YES 
RELLDR=YES 
PFIX=YES 
ECPREAL=YES 
GETVIS=YzEs 
WALTM=YES 


<< ane we eeme ae ae nee ee SED ce CURD EEE mY rem eh AD - “Ee ip cee comb ca ai aie ep aan ae <> cme SE UEP au ED ete ee ae ee eR cp ee «<a et a ae ee ee or 


Required for SSYSPARM for BMS map assemblies 
For maintenance of macros. 

CICS/VS BS auetee data alignment 
eg te ee eg ee ee ree Contd.- 
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Lc L er ee ee er ee ey ray ee eee ee ee | 
| FOPT WALTTM=YES Forced by TP=VTAM 
PCIL=YES Reqd. if the starter system or sample seque- 
ntial terminal job stream is used. 
IDRA=YES optional. If AP=NO in SUPYR, IDRA=YES reduces 


the wait time for CICS partition when a FETCH 
or LOAD macro iS issued by cIics 


FASTTR=YES Only if YSAM is the main access method 


HLPI translator debe dake | 
accee came sce sasay ase mee. won wane me este setae “ume snip atm tar ee umm sete aD “<0KD “UND SOQ sem “ebm Sem waste mi =ERDY “OnmD SED CORED ‘ont funih “END uD SEND MNES “ONDE “WD SOND HED ee RD SID eu ene ct | 
Where n = 302K (Tor Jone + JFJOK for DL/I | 
ee ce seen coe SORE “em Cette tute NaS (AE WHE SA “ANID “eA “age MINT HED ‘nanny ED “AED SUD OHIID Senge GOD <A “RED WEED SND REED SES GS OS GERD AO AND RRS AED OED ce ED en ED cD wey cD seem eee } 
Forced by VSAM - 10 15 the minimum value | 
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| 
| 
| | 
| | 
| 
| | 
| 
| RPS=YES If it is to be used in CICS. For CIcS ISAM | 
| files also specify RPS=SVA in DFHFCT TYPE= | 
i LOGICMOD, in FCT. | 
i VSAM=YES For aux. temporary storage,VSAM and DL/I. | 
| AB=YES If system recovery table or DL/I are used | 
| OC=YES for CICS console support | 
| PC=YES tor system recovery and system init. pgms. | 
| IT=YES for task control program | 
| TOD=YES for interval control and keypoint pgm. | 
| RELLDR=YES for loading and relocating all CICS modules 1 
{ PFIX=YES reqd. by CICS journaling, BTAM or CICS progs. | 
| defined FIX=YES in NLT/ALT or RES=FIX in PPT. | 
| | 
| GETVIS=YES Forced by TP=VTAM, and VSAM=YES. Reqd. if | 
| parameters passed to trace utility pgm. | 
| Reqd. for working storage of formatted dump | 
i and dump utuility programs, unless sufficient | 
i storage allocated in DFHFDP, DFHDUP. Initial | 
| allocations 4k and 8k resply. | 
| SYSFIL=YES reqd. if DASD used aS intermediate storage for| 
| 
| 
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|------ 
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9-13.1____TRANSPERRING __TO__ _CIes/DOS/VS____1.4____ GENERAL 


CONSIDERATIONS 

CiCcS/DOS/VS Version 1 Release 4.0 1S source code compatible 
with all previous releases of Version 1 at the application 
program interface (i.e. macro level), with minor exceptions 
noted below aS conversion considerations. This means that 
application proyrams developed for previous releases need, 
at most, to be reassembled or recompiled to operate with 
Version 1 Release 4.0. 


CICS/DOS/VS Version 1 Release 4.0 is object code compatible 
With Releases 1.0, 1.1, 2.0 and 3.0 of Version 1 at the 
level of the macros and controi blocks as described in the 
Application Programmer's Referen Manual (5C33-0056) for 
Releases prior to 4.0. Object code compatibility cannot be 
guaranteed for those programs that use facilities outside 
those described in the above manual. 


Note: All tables from previous releas2s of CICS should be 
reassembled against CICS/DOS/VS Version 1 Release 4.0 


» Ail programs assembled before Version 1 Release 1.0, 
(Strictiy a those which address the fCTTE), must be 
reassembled for release 1.4 This is due to the change in 
offsets of the fCTTE control block, notably ICTTEDA. 
This will therefore include all applications uSing BMS. 


* 3767. The [Interactive Logical Unit can execute 
applications written for 2740/2741 terminals, provided 
that BMS 1S used, and that applications do not make use 
of the Attention and Interrupt features of the device. A 
new BMS map will be needed. 
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° 3770. Applications written for present batch devices can 
use the Batch Logical Unit if they make use of BMS and 
Logical Record Presentation, and do not make use of the 
Interrupt and Attention features of the device. A BMS 
map re-assembly will be necessary to include the logical 
device code. 


9-13.2_ INSTALLATION CONSIDERATIONS 


This section contains additional information on CICS/DOS/VS 
Version Release 4 Modification Level 0. 


CrTYPE RPG~IL_ APPLICATIONS 

C-type RPG -II applications, that 18S those which have CICS 
Without DL/I, will give an unresolved external reference for 
DLZLI000 if Standard Data Transfer is used and DL/I is not 
installed. This unresolved reference should be ignored. 


The Execution Diagnostic Facility (EDF) programs cannot be 
generate using the CICS/DOS/VS sysgen process. The EDF 
programs are supplied on the pregenerated full function core 
image library (A5746XX3.STARTER.R14 Therefore, if a user 1S 
not intending to use the Starter system but wants to use 
EDF, he must install the Starter system temporarily and copy 
the EDF programs to his CICS/DOS/VS private or system core 
image library. 


The EDF programs are: 
DFHEDFP DFHEDFX DFHEDFD DFHEDFM ODFHEDFF DFHEDFR 


In order to use EDF in two-terminal mode the EDF display 
terminal m have TRANSCEIVE status. Users of ELS must, 
therefore, use the Master Terminal facility to aiter the 
Status of the EDF display terminal from TRANSACTION (the 
default) to TRANSCEIVE before uSing EDF in two-terminal 
mode, 
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INTERSYSTENS CONMUNTICATION SAMPLE APPLICATIONS 
Information on the ISC message routing sample application 
program (in PL/I) supplied in the starter system, is given 
in the Systems Programmer's Guide, Appendix C. 


SYSGEN CHANGES 

DFHSG will allow a suffix to be coded on the PROGRAM=TBP 
macro, aS as the PROGRAM=DBP. It is also possible to 
override the value of DLI= coded on the TYPE=INITIAL macro 
by coding DLI= on the PROGRAM= and PROGRAM=TBP macros. Both 
of these facilities were used when th starter system was 
generated (the stage 11S in A.DFHSPSG in the primary source 
library). 


SAMPLE APPLICATIONS 


The sample programs supplied with the starter system and the 
operating information to execute them iS given in the 
Systems Programmer's Guide Appendix C. 


DAMPLE TABLES 

Although ELS users do not have to code a Systen 
Initialisation Tabl (SIT), there is a Sif in the ELS core 
image library which is used during an ELS Start up. [t is 
calied DFHSIT on the ELS core image library. The source is 
in Z.DFHSIT1# on the primary source library and it is called 
DFHSIT1# in the microfiche. 


Sign on tables are not suffixable. fhe sample SNTs on the 
ELS and full function libraries are different in content but 
have the same name (ie DFHSNT). The ELS version is called 
DFHSNT1# ain the source iibrary and microfiche. The full 
function version is called DFHSNT1 in the source library and 
nNicrofiche. 


All source books of the sytemsS initialisation tables 


Supplied with the starter system are in 2Z.source book with 
the Same name as the table in question. 
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DPHGEN 

It is important to remember that DFHGEN does not produce JCL 
for private libraries, ie. it does not produce DLBL, EXTENT 
and ASSIGN cards for any private libraries being used. Any 
private libraries should therefore be permanently assigned 
before running jobs produced by DFHGEN. 


TRACE ENTRIES 
The ainternal format of some CICS trace entries has been 
rearranged. Users who have their own auxiliary trace 
decoding programs should check their code. 


INITIALISATION PROGRAMS 

Register usage has been changed in the initialisation 
programs DFHSIP and DFHSIA1 - DFHSIJ1. Users who write 
their own initialisation overlay programs should check their 
code. If DFHSICOM is uSed to pick up register equates etc, 
then reassembly of the overlay will probably be sufficient 
to ailow for the change. As a result of this change 
initialisation overlays have 8K bytes of addressability and 
the statement USING e, SIPBAR2, SIPBAR3 may be included at 
entry point. 


1. Sysgen of TDP - Transient Data Program 
1) DFHSG PROGRAM=TDP 
Specify INTRA=VSAM to indicate that the 
intrapartition queues are t be used with VSAM. 


This option cannot be used when DAM or BDAM is 
specified. 
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2) DCT - Destination Control Table 


DEVICE=device specifies tthe type of device on 
which the DAM intrapartition data Set resides. 
The default is DEVICE=2314,. This operand 
replaces the DEVICE operand that was formerly 
in DFHSG PROGRAM=TDP. 


NOTE: If DFHSG PROGRAM=TDP is generated with 
INTRA=VSAM, the device type specified in this 
operand will be ignored at execution time and 
nee not be Specified. The default of 
DEVICE=2314 will nevertheless be applied and 
the resulting MNOTE can be ignored. 


2. bOS/VS Supervisor Generation 


FOPT VSAM=YES 1s reguired if the intrapartition 
transient data set defined aS a VSAM file. 


3. System Initialisation 


fhe following additional messages may appear on the 
system console depending on the message level setting 
the System Initialisation Table. 


DFH1500 - OPENING INTRAPARTITION ACB 
DFH1500 - INITIALIZING INTRAPARTITION STORAGE 


4. besigning an Efficient CICS/VS System 


DFHSG PROGRAM=TDP, 
INTRA=VSAM 


This operand implies the use of VSAM to provide the 
Intrapartition Transient Data feature. While this will 
normaliy give substantially better performance than the 
DAM version, some additional storage will be required 
to accomodate the VSAM control ainterval. If VSAM is 
not reguired for other features allowance must be made 
for the additional storage required. 


5. Evaluation of the CICS/VS System's Performance 


DFHSG PROGRAM=TDP, 
INTRA=VSABR 


the VSAM version of the Transient Data program provides 
Significant improvements over the DAM version, 
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especially when automatic transSa initiation is used. 
The improvements result from the reduced numbe of 
physical I/0 operations taking place, and reduced 
processor acti Another Significant saving over the DAM 
version arises because VSA does not require the CICS/VS 
partition to wait while an output operation takes 
place. (For DAM, as used by Transient Bata, a systen 
wait is issued following a PUT, thus preventing the 
CICS/VS partition from doing work until the wait is 
Satisfied.) 


Transient Data Intrapartition Data Set 


The Transient Data intrapartition data Set may be 
either a VSAM ESD or direct access (DAM) data set, and 
is used for queuing messages and data Within the 
System. The DTF for the intrapartition data set is 
automatically generated in the DCT, and is opened by 
system initialisation if intrapartition queues are 
being used. | 


If the Transient Data Program to be used was generated 
With INTRA=DAM (the default), the intrapartition data 
set must be direct access. Only one of the access 
methods supported can be used for intrapartition 
transient data during a particular execution of 
CICS/DOS/VYS, since the choice between the two is made 
by selecting a particular TDP when CICS/VS is 
initialised. | : 


VSAM Intrapartition bata Set 


The Systems Programmer's Guide chapter 1.10 has more 
information on the subject. 
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The following considerations apply:- 


e In CICS/VS Release 1.4 the Formatted Dump Program writes 
dumps to the dump data Set uSing the dump control 


- In some cases the dump data set may need to be 
enlarged. 


= It will no longer be necessary to asSiyn SYSLST to 
the cCICS/DOS/VS partition in order to use the 
Formatted Dump Proyram. 


= A SIZE option should pe specified when executing 
DFHDUP if GETVIS support 1S available in the DOS/VS 
Supervisor. SIZE=80K is sufficient. 


= If sEYVIS support is not included then the intial 
allocation of working storage can be increased in 
DFHDUP by changing the field DUWEAREA. 


° A ‘'DEVICE=" parameter card may be supplied in the 
jobstream for DFHDUP, DFHTUP and DFHSTUP. If this i158 
Omitted it must be specified on the console. 


° The aeaning of the SIT override parameter FDP=(,SNAP) 
has been changed. FDP=(,PARIN) provides an equivalent 
function. 


2 The ‘short wait interval’ can now be changed by the 
user. fhe ICVSWT SIT operand or Start-up override 


controls the length of time cicsS/DOS/VS wil wait before 
testing to see 1f disx I/C is complete. 


* Several Release 3.0 sysgen operands are now available as 
Operands on the SIT or as Start-up overrides. For 
compatability reasons they can Still specified at sysgen 
time. 
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They are:- NSD on DFHSG PROGRAM=CSO 
WRKAREA " " - PROGRAM=CSA 
DATFORMS "a #9 1" | 


* he following sysgen operands have been removed and will 
be ignored if encountered. 


DEVICE= on DFHSG PROGRAM=CSU! 
TRDEV= 99 W bE “a ji 
2 lee Pe ee n " n =APTp2 
DEVICE= n " “ sTDP3 
PRTEREQ= it " n =fCcp¢ 


1. The device type must be specified as SYSIPT input 
to the appropriate utility or aS an answer by the 
system operator to a question from the utility. 

2. TLY support is always included. 

3. DEVICE= must be coded on the DFHDCT TYPE=INITIAL 
macro if DAM INTRAPARTITION is used. 

4. PRIREQ aS a sysgen operand has been replaced by 
PRINT as a SIT operand or aS a Start-up override. 

® The cCICS/DOS/VS starter systen contents have been 
Changed Slightly. A complete list of the changes since 
Release 3.0 can be found in th comments in the stage 1 
used to generate the starter system. The stage 1 iS in 
A.~DPHSPSG. 

° The SUBSET has been discontinued. 


* The Entry Level System (ELS) has been introduced to 
replace it. Major differences are: 


- Terminal support is for the 3270 family of terminals 
only. 


= Terminal Support can be via BTAM or VTAM. 
= File control via DAM is not supported. 


a ELS supports Auxiliary Trace and Intrapartition 
Transient Data. 
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- ELS is completely pregenerated and so no sysgen step 


iS necessary. 


= ELS supports only the command level application 


interface. 


= Simplified high level start overrides are provided. 


A DFHSIT table does not have to be prepared. 


For more information about ELS please refer to:- 


WTSC 


= CICS/VS General Information (GC33-0066-2) 


= System/application Design Guide (5C33-00068-1) 


= Entry Level System User's Guide ($C33-0086-0) 


Applications and mapS written for the 3270 group of 
terminals do NOT neea to be changed in order to run on 
terminals which have the alternate screen size facility. 
HoweveL, anyone uSing these terminals should consuit the 
information concerning them in the CICS/VS manuals. New 
operands on the DFHTCT and DFHPCT table macros allow 
user control of the alternate screen size facility. 


There are changes to the CICS/DOS/VS PCT,PPT,DCT macros. 
On their TYPE=IN macros the PAGENXD keyword has been 
replaced by the INDEX keyword. On the PCT TYPE=ENTRY 
macro the RESTART keyword has been added. TYPE=GROUP is 
added to PCT and PPT. Existing source for all these 
tables will still assemble validly, but occurrences of 
PAGENX will be re-interpreted as INDEX=YES. 


VSAM may be selected For intrapartition transient data 
Support. In order to obtain VSAM intrapartition TD: 


= Select VSAM TDP at sysgen if you are not using the 
pregenerated VSAM fTDP. 


- Before the first COLD CICS startup using VSAM TDP, 
run a job to define the VSAM cluster for DFHNTRA. 


= Use appropriate DLBL and EXTENT statements for a 


VSAM DFHNTRA in CICS startup jobstreanm. 
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» Note that odOCTs assembled for Release 4.0 are 
independent of whether VSAM or DAM is used for 
intrapartition TD. 


CICS/DOS/VS AND DOS/VSE MIGRATICN PLANNING 


The Valid Combinations of CIVS/DOS/VS (1.4.0 Base and 1.4.0 
ICR) and DOS/VSE RK 35 are as follows :; 


TYE ame ee a ee wee ee eee ee Tae me me ne ne ee ee me ee me ne we —— ne mem me cee coe — * 

_* DOS/VS * DOS/VSE Rel 35 * 

i Rel 30 Weekes oe] $oessee-ces * 

CICS/DOS/VS = * * CKD dev * FBM dev * 

ne ee ee ee ee oe Ka eee ee TR ae ee me ee ee me —— 

1.4.0 Base (1) * Yes  * Yes (2) * NO * 
* 3% x * 

1.4.0 ICR (3) * No (4) * Yes  * yes (5) * 
Km ee ee RK we a we ee ee Ke we ee a ee ae 


Notes: 
(1)-All pre-assembled supplied modules are assembled on 
DOS/VS Rel 34. Applies for all maintenance pTFs for the 
base release. 


(2) 


(a)-~DFHTCP and DFHTCT must be re-assembled (STAM-ES 
must be used) after installing DOS/VSE-SCP, YVSE/SAF, 
BIAM-ES, ACF/VYTAM or VTAHE, VSE/VSAM, etc. 


(b)~Magrate from (DOS/VS Rel 34 + CICS/SVYS 1.4.0 
base) to (DOS/VSE Rel 35 + CICS/VS 1.4.0 ICR) in 
ohne step (position corresponding to 5). If you 
Cannot manage then use this as the intermediate 
step. 


(3) -Ali pre-assembled Supplied modules are assembled on 


DOS/VSE Rel 35. Applies for all w¢aintenance PTFs for 
the ICR release. 
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(4) 
(a)- NOT RECOMMENDED. THIS NOT A VALID COMBINATION 


(b)- You dont need this combination, becauSe makes 
no sense, 


(c)- Correct intermediate step for migration 1s 
CICS140 base + DOS/VSE Rel 35 (Step 2b). 


(5)-Should be your taryet, if you plan to use DOS/VSE 
or CICS/VS 1.4.0 ICR in your installation. 
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9.14 FIXED BLOCK ARCHITECTURE 


The description below applies to the IBM 3310 and IBM 3370 
FBM DASD. 


2-14.1_ OVERVIEW 


FBM is a new DASD architecture in which the main difference 
to Count-Key-Data resides not in how to address the device 
but in the addressing within the device. 


FBM appears to the programming aS comprising a contiguously 
numbered set of physSical records, starting from zero and 
going to the device capacity. 


The size of each physical record is constant and is a 
multiple of 512 bytes. In the current implementation is 512 
only. 


Channel programs may read or write single or multiple 
consecutive records at each request. 


There is no hardware implementation of a key-search 
Capability. 


The Access Methods providing explicit support for FBM 
devices are VSAM and SAM. | 


The CICS/VS support of FBM devices coming in CICS/VS V1 R4.1 
has the objective of providing most of the functions for 
datasets on FBM devices. 


The following areas of CICS/VS are affected in order to 
provide support for FBM devices: 
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° File Control 

° Temporary Storaye 

° Journalling 

° Transient Data 

° Terminal Control 

° Dump Control 

° Auxiliary Trace 

® Auto-Statistics 

* Initialization / Termination 


» Keypointing 


FILE-CONTROL 


The Fale Control Program will have no Changes caused by the 
FBM support. Datasets residing on CkKD-devices will continue 
to be supported by VSAM, ISAM, or DAM aS in the current 
CICS/VS release. Datasets residing on FBM-devices will be 
supported only by VSAM. 


TEMPORARY STORAGE 


FBM support will be transparent to CICS/VS Since Temporary 
Storaye uses VSAM when auxiliary storage is requested. 
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JOURNALLING 


Journal-control will be modified to support disk journals on 
FBM devices through the regular SAM workfile interfaces. 


The corresponding specification in JCT is JDEVICE=FBA. 


TRANSIENT-DATA 


CICS/VS 1.4.21 will support both Extra and Intrapartition 
destinations on FBM devices. 


DEVICE=FPBA will be accepted in the DFHDCT macro for 
extrapartition destinations. 


The Support for intrapartition destinations on FBM 
devices iS given via VSAM only. 


The following must be specified in the generation of 


Transient Data Program if aintrapartition destinations 
are to be resident on FBM devices. 


DFHSG PROGRAM=TDP,INTRA=(..., VSAM) ,.-. 


Internally, when VSAM is chosen, intrapartition 


transient data PUT requests will be satisfied by the 
allocation of space from the current control-ainterval 
for the specified destination and the chaining together 
of such control-intervals. This iS analogous with the 
current DAM approach, which allocates space from the 
current track for the specified destination, and chains 
together tracks to form queues. Transient-Data 
Recovery, Acquisition, Disposition, and Initialization 
functions will support this option. 
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TERMINAL-CONTROL 

Simulated terminals using FBM devices will be supported as 
they are currently supported using CKD devices... 

Generation of the Yerminal Control Table will allow FBM in 


the DEVICE= operand 


DFHTCT TYPE=SDSCI,...,DEVICE=FBA,... 


DUMP-CONTROL 


DFHDCP and DFHDUP will support dump datasets residing on FBM 
devices. FBH will be valid in the DEVICE= operands of the 
following macros: 


DFHSG PROGRAM=CSU,...,DEVICE=FBA 
DFHSG PROGRAM=DCP,...,DEVICE=FBA 


and also in the Operator dialogue when executing the Dump 
Utility Proyram. 


A dynamic test for DPF device-type will be made before 
entering end-of-extent processing, and, for non-FBM, the 


current code will be executed; for FEM, new code will avoid 
writing outside of the extent. 


AUXILIARY TRACE 


DFHTRP and DFHTUP will support Trace datasets residing on 
FBM devices, The following are the cotrespondent 
specifications: 


DFHSG PROGRAM=CSU,...,DEVICE=FBA 
DFHSG PROGRAM=TRP,...,DEVICE=FBA 


FBM will also be accepted in the start-up parameters when 
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executing the Trace Utility Progran. 


DFHTRP uses contents of the DTFSD control-block to 
antecipate end-of-extent, and the code will be modified in 
the same way aS in Dump Control Progran.. 


STATISTICS 


No modification of the online modules will be made in order 
to support FBM. The only difference will be in the offline 
printing of statistics where FBM (besides of TAPE, 2314, 
3330 and 3340) will be accepted as a reply to message: 


ENTER INPUT DEVICE: TAPE, 2314, 4... 


if the statistics summarization utility program is generated 
to be used for more than one input device type. 


WARM KEYPOINTING AND EMERGENCY RESTART 


The Restart Dataset 1S used during Warm Keypointing and 
during the Emergency Restart. In the current implementation 
of CICS/VS (CICS/VS 1.4.0 ) Restart Dataset 1S a DAMS 
dataset. In order to Support Restart Dataset residing on FBM 
device it will be modified in order to use SAM workfile. 


Althouyh CICS/OS/VS will not support FBM at 1.4.1 level, it 
will have also the Restart Dataset modified to SAM in the 
interest of consistency. 


FBA will be valid in the DEVICE= operand when generaring 
Keypoint Program. 
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IMPACT ON APPLICATION PROGRAMMER 


Since the only existing support for user databases residing 
on FBN 1S via VSAM interface, application programs which 
use macros or command-level requests contalninyg parameters 
peculiar to DAM will have to be modified. 


IMPACT ON SYSTEM PROGRAMMERS 


The impact on system programmer 1S minimum, in order to get 
FBM support: 


a) Check for YSAK option in DFHSG PROGRAM=TEP 
b) Check for FBA option in the following macros: 


DFHSG TYPE=INITIAL,...,DEVICE= 
DFHSG PROGRAM=CSU,...,DEVICiu= 
DPHSG PROGRAM=DCP,...,DEVICL= 
DFHSG PROGRAM=TRP,...,DHEVICE= 
DFHSG PROGRAM=KPP,...,DEVICE= 
DFHTCOT TYPE=SDSCi,...,vEVICH= 
DFEHDOT TYPE=SDSCI,...,0UeVICE= 
DFHICT TYPE=ENTRY,...,JDEVICE= 
DFHSG PROGRAM=CSU,...,TRDEV= 


IMPACT ON COMPUTER OPERATOR 


Job Control statments for all DASD datasets residentS on 
FBM-devices are affected. Changes are the following: 


1) Intrapartition transient dataset, OFHNTRA, may 
be optionally a VSAM dataset. 
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2) The Restart dataset, DFHRSD, must be defined as 
Sequential dataset (SD instead of DA in the 
DLBL card of JCL). 


3) When executing the Trace, Duap and the 
Statistics Utility Program use of FBM in 
device-specification in JCL and operator 
dialoyjues,. 


The FBA specification will be accepted aS previously 
Stated. Some degree of device-independence will however 
be provided by DOS/VS SAM allowing the uSer in many 
cases, to maintain the current specification (2314, 
3330, 3340) when moving to a FBM device. 

A 2314 specification, for example, with a blocksize of 
7294 bytes (or fewer) will be accepted when the dataset 
1S assigned toa  FBM device (CCS/VS wiil chanye from 
2314 to FBM at OPEN time). If, nowever, the blocksize 
has to be increased to more than 7294, then due to 
access method restrictions the 2314 specification will 
not be accepted any longer, and the 2314 specifications 
has to be changed to FBM. 


An Intrapartition Dataset created by CAM implementation 
of Transient Data Program will not pe usable under the 
VSAM option of TDP or vice-versa. 


The Asynchronous Tansaction Program (ATP) will execute 
only with the DAM option of TranSient Data Program. 
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This chapter contains a Summary of details for the major 
projramming facilities available to the DOS/VSE user. These 
consist of the basic language compilers (DOS/¥S COBOL, DOS 
PL/I Optimizing Compiler and Libraries, DOS/VS RPG ITI and 
DOS FORTRAN IV Library) and the major productivity aid 
DMS/CICS/VS. | 


The information provided is as detailed and accurate as is 
the latest documentation regarding Functional Specifications 
and other literature received by WSC Boeblingen. It is 
important to consider the schedules for the different 
products when using to the information available in this 
guide. For instance, the most important DMS/CICS/VS-DOS 
enhancements to DMS/VS-DOS are incorporated in Release 2.0 
planned to be available by end 1979. Then, detailed and 
Stable information is not available for this product at this 
time frame. 


Please notice that WTSC Boeblinjgen Support for COBOL and 
PL/I has been defined as ‘limited support’. 


FORTRAN is not supported by WISC Boeblingen. 


A discussion of the new SORT/MERGE Version 2 product, w#ill 
also be included here for convenience. 
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10.2 PROGRAMMING FACILITIES DESCRIBED 
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The software coaponents to be discussed and their respective 
Version/Releases are: 


| 
| PRODUCT | RELEASE { 
Poe a ee ee ee es eC CT eee a ee ep Eee ee ra areca Speers eke ae yee i 
| | | 
} DOS/SVS COBOL Compiler and 5746-CB1] Ze j 
| Library | | 
| i 
{ i | 
| DOS PL/I Optimizing Compiler 5746-PL3] 520 | 
| and Libraries j | 
| | l 
| { | | 
| DOS/SVS RPG-IT 5746-RG1] 3.0 | 
| | | 
| | | 
| DOS FORTRAN IV Library 5746-LN3] 3.90 | 
| Option 1 | | 
| | | 
| | | 
|} DMS/CICS/VS | 5746-XC4| 1.0 
i 7 | 220 | 
| 340 i 
| | | 
| 7 | i 
1} DOS/SVS SORT/MERGE Version 2 5746-SH2 | Za 0 } 
| ia | 
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It 15 not intended to discuss these products in great 
detail, but where new products (or Version/Releases) are 
concerned, brief comments on new functions and enhancements 
will be given. 
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10.3 DOS/VS COBOL AND LIBRARY (3746-CB1) 

Status : Program Product 

Latest Release . i 269 

Announced : 1/79 

Planned Availability > 4/T9 


Manuals Available 


u/719 


SIPO's Available DOS/VSE SIPO/E (Plan.Avail.30Q79) 


VM/DOS/V¥S SIPO/E (Plan.Avail.4Q79) 


o¢ 


Selected Product Line > yes 
Installation License s N/A 
Pre-Installation Test ; 30 days 


Program Services : Central Service until discontinued 
upon 12 months written notice. 


Local Service at no charge until 


12/31/73 then Local Licensed 
Program Support. 
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This modification to Release 2 of the DOS/VS COBOL Compiler 
and Library will give uSers of DOS/VSE with VSE/Advanced 
Function Release 1 access to Fixed Block disk devices 
through DOS/VS COBOL. The rest of the functions have not 
Chanjged from the Release 2.4. For instance, the VSAM support 
is equivalent to that available with DOS/VS Release 28. 


The compiler minimum storage requirement is increased to 64K 
bytes of storage. 
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The following important points Should be noted :; 


(1) DOS/VS COBOL 2.5 Supports Fixed Block disk devices for 
SAM and VSAM files, and for compiler work files. 


VSE/VSAM iS cequired for VSAM file support. The 
specifications for VSAM files are not changed. 


The specification for SAM files 18 as follows (notice 
the forced combination -UT-FBA1-S- ):; 


SELECT filename ASSIGN TO SY¥Snnn-UT-FBA1-S-dlblfilename. 


(11) The compiler requires a minimum of 64k bytes of 
Storage. The working files defined on FBA devices are 
specified by means of JCL Statements. 


(111) DOS/V¥S COBOL 2.5 does not support all of the functions 
included in VSE/VSAM. A list showing what is supported 
is illustrated in a section below . 


(iv) The VMyCMS user who has Display Management System/CMS 
(DMS/CMS) and VWM/Interactive File Sharing (VM/IFS) 
facilities intalled on his system may also utilize the 
corresponding CALL interface itn his COBOL program. 


fhe formats of the CALL parameters and data areas used 
to invoke DMS/CMS and VM/IFS services are not described 
here. They have the same meanings and equivalent layout 
as described for RPG-II in this guide. 
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Program Prerequisites 


| 
| - SORT/MERGE 
| 


| 
| 
|Required if application program requires the SORT { 
Jfacility - any Supported DOS/VSE SORT/MERGE product. |] 

I 


[Unit Record Support. Any DOS/VS supported device. 


| DAS 
| 


' 


|Data Manayement Support. 


10.6 


D Support 
2311 

2314 

2319 
3330-1,2 
3333 


, 3330-11 


3340 
3344 
3350 
3310,3370 


ae ae alm ip cam i a a en a a ep eh ee a 


SAM 
DAM 
ISAM 
VSAM 


1 
| 
|} At least a card reader (or equivalent) and line | 
printer (or equivalent) are required. | 
Also supported are - 3504 with OMR, 3881 OMR, j 
3886 OCR, 3540. l 
| 


Any DOS/VS supported device. I 
SYSO002 - 004 and SYS005 (optional) work files may be| 
asSignhed to tape. 


Native mode, 


Native mode. 
FBA disk types for SAM and VSAM files ONLY. 


> RE WE ane ner ~<a 4 cmp COED Vai ~<fem <Ee GE “En cen “El cm OD co sem ee a <a EE ee em Oe en ee ee ee ee ee ae ee ee ee ee ee ee ee ee ee ee ee a 


| 
| 
| 
; 
| 
| 
| 
l 
| 
| 
| 
| 
l 
| 
| 
| 


| 
| Not for FBA disk devices. 

| Not for 3330-11, 3350 and FBA disk devices. 
} See notes below for specific Support. 

l 
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SUPERVISOR GENERATION OPTIONS 
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The following is a breakdown of the mandatory and suggested 


Supervisor parameters within the Supervisor generation 

macros : 

si pi | sae as ans “cy: “an ap coh ws. abi | cen Mm team ata QR SAR tN AnD MANE am WED OOD =ANRD AID COLA WAND GAINS CORD OLED GOED OND RA AGES SOD SAID SERED LAD OND UD OED SOIR SEED SED LD A ED SD SERN AY OS A ED ED EP | 
{MACRO | PARAMETER REMARKS | 
Looe ere Ship ree ter ie ae Ug ee a eT Tg ee ee Rae ee are yee eel ere eee ee? | 
| | | | 
{SUPVR | ASCII=YES j Only if ASCII support needed. | 
| i | 
[nen=es iments ea [peg tree eee ee eee | 
}NOTE. The following FOPT parameters, recomended for DOS/VS, are 


ane eee deere eee eee em ahha (SE eee 


> —- wee a a an 


| 

| VSTAR 
| is iS Smo 
| 

| IOTAB 


(Sees 5 


OL S04 STI 


Standard under DOS/VSE: 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


AB=YES 
GETVIS=YES 
PCIL=YES 
RELLDR=YES 
VSAM=YES 


<> wee enue Jee CED item cent see SE ee wee ee 


a > a ae ih ae <a ee CE we <a ee ce 


wee qu «mem eaED ql st qa au CD GR WER a -m 


Required 

Forced by VSAM (if reguired) and reguired for 
3886 OCR Support 

Support for Private Core Image Lib. required 
Required 

If VSAM support required 
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AS required by VSE/VSAM (from NPARTS+#¢2 to 255) ] 
I 
ae a ee i a a ! 
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VSECZVSAN SUPPORT 


This section briefly summarizes the VSE/VSAM functions which 
acre available to the COBOL programmer ; 
(2) Data Set Organization 
~ VSAM KSDS. Keyed- direct and sequential access are 
both supported, ancluding READ, WRITE, 
UPDATE and DELETE functions. 
- VSAM ESDS. Sequential access is the only Supported. 
READ, WRITE and UPDATE same length 
record in place are available functions. 
No DELETE record function exists. 
(ii) Password Protection 
- READ 
- UPDATE 
(111) No other VSE/VSAM functions are Supported, but as already 


indicated, all VSAM Release 1 functions (DOS/VS Release28) 
are available. 
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GC28-6473- 
GC28-6487- 
SC28-6478- 
SC28-6479- 
SC28-6469- 
GC26-6394- 


LY28-6423- 
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General Information Manual 
Program Product Specifications 
Programmer's Guide 
Installation Reference Manual 
CMS Users Guide for COSOL 

DOS Full ANS COBOL 


Compiler Program Logic 
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status 

Latest Release 
Announced 

Planned Availability 
Manuals Available 


SIPO's Available 


Selected Product Line 
Installation License 
Pre-Instailation Test 


Program Services 
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Program Product 
5.0 
1/73 
4/79 
u/79 


(Plan. Avail. 3079) 
(Plan.Avail. 4079) 


DOS/VSE SIPO/E 
VM/DOS/VS SIPO/E 


yes 
N/A 
30 days 


Central Service until discontinued 
upon 12 months written notice. 


Local Service at no 
12/31/79 then 
Program Support. 


charge until 
Local Licensed 
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10.4.1 PRODUCT FUNCTION 


This enhancement to Release 5 of the DOS PL/I Optimizing 
Compiler and Libraries will give users of DOS/VSE with 
VSE/Advanced Function access to Fixed Block disk devices 
through DOS PL/I. 


PL/I 1S a general purpose programming language which can he 
used to program both commercial and Scientific applications. 
It iS particularly useful for applications that require a 
combination of techniques to be used in a prograaga. 


PL/I support under DOS/VS is provided by the PL/I Optimizing 
Compiler and by two object-time libraries, the resident and 
transient libraries. The PL/I Optimizing Compiler is 
designed to provide optimized object programs from a 
comprehensive level of PL/I. It provides a high level of 
PL/I language diagnostics at both compile-time and 
object-time, and optimized object proyjrams. 


If optimization is specified, the compiler will process the 
PL/I source program, reoryanizing 1t if necessary, So as to 
produce an efficient object program. If optimization is not 
specified, compilation time will be reduced. 


A facility 1s provided by the compiler to allow 
communication between PL/I modules and modules produced by 
certain FORTRAN, RPG and COBOL compilers. The language 
level implemented by the optimizing compiler contains 
extensions beyond the PL/I D and F level subsets. 


Two object-time libraries are required for the execution of 
object modules produced by the optimizing compiler. These 
libraries contain subroutines which must be combined with 
the object module to produce an executable program (the PL/I 
resident library), and other subroutines which are required 
dynamically as the object program is being executed (the 
PL/I transient library). 


Both the resident and transient libraries are separate 
Proyram Products. 


O4/O4/STI IBM INTERNAL USE 10.11 


Chapter 10.4 DOS/VSE PLANNING GUIDE 
PROGRAMMING FACILITIES Volume II | 2210-9826 


The following important points should be noted ; 


(1) 


(11) 


(111) 


(iv) 


10.12 


DOS PL/I Optimizing Compiler 5.0 supports the use of 
FBA disk device types for SAM and VSAM files, and 
compiler workfiles. VSE/VSAM is required to access VSAM 
datasets. The specification for VSAM files has not 
changed. 


The access to SAM files on FBA devices reguires an FBA 
device type specification. This iS accomplished by 
coding the three caracters 'FBA' in the ‘physical 
device type’ in the MEDIUM option of the ENVIRONMENT 
attribute. AS an example: 


DCL SAMFILE FILE...ENV (RECZISE (80) MEDIUM (SYS007,FBA)...) 3 


The specifications for working files on FBA devices is 
through JCL statements. 


The compiler minimum storage reguirement is increased 
to 50K bytes of storage. 


DOS PL/I Optimizing Compiler 5.0 supports many of the 
functions available in VSE/VSAM. These are listed ina 
section below. 


The VM/CMS user who has Display Management System/CMS 
(DMS/CMS) and VM/Interactive File Sharing (VM/IFS) 
facilities intalled on his system may also utilize the 
corresponding CALL interface in his PL/I progran. 


The tormats of the CALL parameters and data areas used 
to invoke DMS/CMS and VM/IFS services are not described 
here. They have the Same meanings and equivalent layout 
as described for RPG-II in this guide. 
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{| DE 


PENDENCY ITE 


| REMARKS | 


leacues aera a a resale rica aa 


Program Prerequisites 


| 
| 
| - SORT/MERGE 
| 


jTape Support 


| <a> «a «Ep “ite <me 6m a am Wee sep cen em =e <P ae 


[DASD Support 
{ - 2311 


nem ome eee ee ee eee ae 


{ 
' 
f 
{ 
i 
i 
{ 
I 
! 
I 
{ 
{ 
{ 
{ 
1 


NOTE 


3350 


AD CD A OR ED AP aD oS CUED cu cee ~~ ane uee wee 


| 
| 
| Required if application program requires the SORT | 
| facility - any Supported DOS/VS SORT/MERGE product. | 

| 


Unit Record Support. Any DOS/VS supported device. 


printer (or equivalent) are required. 


| 
l 
| At least a card reader (or equivalent) and a line | 
| 
Also supported are — 3881 OMR, 3540. | 

| 


Native mode 


Native mode. 
FBA disk types tor SAM and VSAM files ONLY. 


th de aneet ab ae ae aed eu sent Geet Gee eee ee 


ne em ae ee ce ae ee ee ee a ae eee eee ee es ee eee eee ee ae ee ee een en <r ee 0 se ee ee cr me wee fem 4 Oe ene Cm ee ee ee i <i ee oe ee oo 


CREED 


| 
| Not for PBA disk devices. 

|} Not for 3330-11, 3350 and FBA disk devices. 
| See notes below for specific support. 
| 


ma quer Gee de eeu) aueu cee 


The Floating Point feature MUST be installed on the CPU. 
The Decimal and Floating Point Instruction sets are required. 


04/04/79 
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SUPERVISOR GENERATION OPTIONS 


The following is a breakdown of the mandatory and suggested 


Supervisor parameters within the Supervisor generation 

macros : 

aac cia re ee [ee et ee ae ee ana aaa | 
|MACRO | PARAMETER | REMARKS | 
ara joe ere ee rere ene Ge a ey ag ge ee ee ne er ee | 
| | | | 
{CONFG | FP=YES ] Required | 
| | | | 
fae ae a a Ue ee ee age ae cg re rane pnp eg one te et ng ee ee | 
| | 
|NOTE. The following FOPT parameters, recomended for bDOS/VS, are | 
| Standard under DOS/VSE: | 
| i i 
|FOPT | PCIL=YES > | Support for Private Core Image Lib. required | 
| }] PC=YES { Required | : | 
| | WAITM=YES } Required | 
| ] RELLDR=YES |} Required | 
| }] TOD=YES | To use TIME built-in function | 
| |} IT=YES | To use DELAY built-in function | 
| } VSAM=YES | If VSAM support required | 
| |] GETVIS=YES | Forced by VSAM | 
| | | | | 
eats a ee, aa a as ei ee nT eae as 
| | | | 
|¥VSTAB | VSIZE=nk j AS required by the system when in 370 mode | 
| i | | 
ae aaa Le gy ae ee ee eee | 
| | | | 
{|TIOTAB | NRES=n | AS required by VSE/VSAM (from NPARTS+#2 to 255) | 
| | | | 
aaa aaa aaa aaa a a aaa | 
10.74 IBM INTERNAL USE | 04/04/79 


DOS/VSE PLANNING GUIDE Chapter 10.4 
Z210-982b6 Volume II PROGRAMMING FACTLITIES 


The following section briefly describes the VSE/VSAM 
functions available to the PL/I programmer ; 


(1) Data Set Organization 
- VSAM KSDS Keyed Sequential and keyed direct access 
~ VSAM ESDS Addressed sequential and direct access 
Via RBA 
- VSAM RRDS Keyed sequential and keyed direct access 


Via Relative Record Number 
(11) Alternate Index Support 


- VSAM KSDS 
- VSAK ESDS 


(i111) Password Protection 


- READ 
~ UPDATE 


(iv) Skip Sequential Performance Option 
- VSAM KSDS 

{v) Backward Processiny Option 
- Get previous record 

(vi) Re-Usable Data Set Option 


- Eliminates need for VSAM Access Method Services 
DELETE/DEFINE operations for temporary/work files 


(vii) Buffer Specifications 
- Program iS able to specify the number of INDEX and 
DATA buffers as well as the total buffer space to 
be allocated at execution time. 


(v1i1)Alternate Index Duplicate Key READ/WRITE Built-In Function 


- Simplifies detection of duplicate key status 
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GC33-0004- 
SC33-0008- 
SC33-0019- 
GC33-0005- 
SX33-6001- 
SC33-0035- 
SC33-0020- 
SC33-0051- 
GC33-0016- 
GC33-0017- 
GC33-0018- 
GC33-0046- 


SC33-0021- 
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General Information Manual 
Programmer's Guide 


Execution Logic 


Language Reference Manual 


Reference Data 

Transient Library Messages 

Installation 

CMS Users Guide for PL/I 

pESgeau PESduct Specifications - PL/I Opt. Compiler 
Program Product Specifications - PL/I Resident Library 
Program Product Specifications - PL/I Transient Library 
Design Objectives 


Compiler Messages 
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ROU caNbe cuth cin en can ete se 


status > Program Product 

Latest Release > 3.0 

Announced : Wiy 

Planned Availability >: 4/79 (Initial limited availability) 


6/79 (General availability) 


Manuals Available u/79 


SIPO's Available 


os 


DOS/VSE SIPO/E (Plan.Avail. 3079) 
VM/SIPO/E (plan.Avail.3Q79) 
VM/DOS/VS SIPO/E (Plan.Avail.4Q79) 
Selected Product Line > yes 
Installation License > NSA 


Pre-Installation Test 30 days 


Central Service until discontinued 
upon 12 months written notice. 


Program Services 


Local Service at no charge until 
12/31/79 then Local Licensed 
Program Support. 
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Release 1.0 (GC 33-6030-0 GIM manual) 


- 3330 Model 11 Disk Storage 
- 3350 Direct Access Storaye Facility 
- VSAM puncte one (KSDS, ESDS and &RDS) 
= 573 Batch equivalent functions 


- Auto Report as part of the Licensed P.P. 


Release 2.0 (GC33-6030-1 GIM manual) 


- CICS/DOS/VS EXEC Command Level interface 
- DL/I DOS/VS interface (RQDLTI) 


~ CALL interface to COBOL, PL/1, Assembler 
and RPG-ITI | | 


- Data Structures (binary mode, working 
areas, redefinitions, etc.) 


- Revised DOS/VS RPG-II logic cycle (only 
Calculations (C) specifications reguired) 


~-~ Figurative constants (*BLANK/S, *ZERO/S) 
- Symbolic dump 


= Improved error handling (*PSSR Subroutine 
takes control) | 


10.18 IBM INTERNAL USE _ Ow /O4/79 


DOS/VSE PLANNING GUIDE Chapter 10.5 
2410-9826 Volume IT PROGRAMMING FACILITIES 


Release 3.0 (GC33-6030-2 GIM manual) 
(Information about this release iS con- 
tained in this chapter). 


-~ Online Source Code Entry under VSE/ICCF 
and CMS/DOS 


- Interactive compiler under VSE/ICCF and 
CMS/DOS 


-~ Error Message Cross-Referencing 
- Native Language Text Capability 
- Display Management Sistem/CMS (DMS/CMS) 
- VM/Interactive File Sharing (VS/IFS) 
- Support of IBM 4300 Processors 
~ Fixed Biock Architecture {FBA) devices 


- Dropping of IBM 2321 Data Cell Support 


O&sO04/7T9 IBM INTERNAL USE : 10.19 


Chapter 10.5 DOS/VSE PLANNING GUIDE 
PROGRAMMING FACILITIES Volume II ZZ 10-9826 


DOS/VS RPGII 1S a programming language that can be used to 
create programs to perform a wide variety of commercial data 
processing jobs. Release 3 of DOS/VS RPGIT is an 
enhancement of the current Release 2 compiler mainly for 
interactive usage. | 7 


DOS/VS RPGII Releases 2 and 3 run under the control of 
DOS/VSE with VS£/aAdvanced Functions or CMS in VA/370 Release 
6 with VM/BSE or VYM/SE Program Products. 


The DOS/SVS RPGII release 3 compiler supports all Fixed Block 
Mode devices wich are supported by the data management of 
DOS/VSE on the 4331 and 4341 Processors for SAM and VSAM 
filse, and compiler workfiles. VSE/VSAM is required for 
VSAM file support. 


Davee r ives: 


DED Ce ERS CN AERA Melle Ete aD SER dene 


The primary purpose of the RPGII Source Entry facility 
(RSEF) is to provide an easy-to-use, interactive, RPGII 
source program entry and modification facility which 
eliminates the need for column counting on the screen, and 
also provides line-by-line syntax checking. It is not 
intended to replace the standard editing facilities of the 
host system, and for this reason only those basic editorial 
facilities are provided which are necessary for positioning 
within the source. 


Source languaye input and alteration are possible under 
control of the specification requirements of the RPGII 
language and of the Autoreport feature. This means, that 
the source being entered or modified is checked for correct 
Syntax, as far as possible on a line-by-line basis, and that 
the user 1S informed immediately when syntactical errors are 
detected in the input, so that corrective action can be 
taken straight away, before the source 1S submitted to the 
compiler. | = 


The new compiler features are aimed at providing the 
interactive user with facilities compatible with those 
available for other high level lanyuages when compiling in 
an interactive environment. ; 7 
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Main ojective of this release is to guide the batch oriented 
RPGIIT user to a terminal oriented programming environment. 
The features implemented for this purpose are: 


(1) INTERACTIVE SOURCE ENTRY FACILITIES 


- RPG Source Entry Facility (RSEF) 


(21) INTERACTIVE COMPILER FACILITIES 


- Optional cataloging of object deck as CMS TExT 
or VSE/ICCF library member 

- Optional cataloging of listing as CMS LISTING file 
(this feature iS not available under VSE/ICCF) 

- ferminal output for error messajgeS at compile time 

- Cross Reference of all error messages 

- Display Management System/CMS CALL capability for 
programs running under VM/CMS with the ODMS/CMHS 
facilities installed 

- VWM/Interactive File Sharing CALL support for 
programs running under VM/CMS with the VH/IFS 
facilities installed | : | 


(iii) FBA SUPPORT 


- Support of compiler work files and, user SAM and 
VSAM files for all IBM DASD devices Supported by 
DOS/VYSE with VS&/advanced Functions on the IBM 
4300 ProceSSorcs. | 


The general requirements of RPGII ReleaSe 3.0 are based on 
the need for convenient online terminal facilities for the 
column oriented RPG source language, since column counting 
is time consuming and error prone. A template for the 
chosen RPGII specification type will be displayed in a 
convenient layout allowing the correct positioning of Single 
or multiple entries for a line of input. | 


In addition, the terminal uSer has options avaiiable in an 
interactive environment, which allow him to control the 
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storing of the compiler output (card deck or listing) on his 
host library facilities. 
The VM/CMS user who has DMS/CMS and YM/IFS facilities 


installed on his system may also utilize the corresponding 
CALL interface in his RPGII program. | 


Types of User 
Two groups of users are envisaged: 


- VSE/ICCF users 
- CMS/DOS users 
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The CMS/DOS environment must be active with the VSAM option 
set on, to run the RPG compiler as well as to execute RSEF. 


Wnen cunning under CMS/DOS there are two possible cases 


(a) no DOS/VSE SYSRES attached: SET DOS ON (VSAM 
GLOBAL DOSLIB libname 


(b) DOS/VSE SYSRES is attached: SET DOS ON x (¥SAM 


In case (a), both the RPGII compiler and RSEF must reside on 
a CMS DOSLIB library. In case (b), they may reside ona 
private or system core image library as well. fhe library 
being on disk x. 


In case (a), where no SYSRES 18 attached, Source Library 
facilities are not available and therefore the uSer cannot 
employ the /COPY and /INSERYT commands for the Autoreport 
feature and, DL/1? and CICS/VS translators. The Release 3.0 
compiler however is not affected by the lack of Source 
Statement libraries, and can run in caSe (a) Without 
restrictions. 


In case {b), there are no known restrictions for any of the 
facilities available with RPGII Release 3.0. The user 
invokes RSEF by entering following at the terminal: 


RSEF filename filetype filemode 


defaults are: - filename= the uSer will be prompted 
to give a filename 


- filetype= RPGII 


- filemode= Al 


The file thus specified will be located and will be used as 
base for subsequent editing. If it cannot be found, a new 
file under this name will be created. The filename, filetype 
and filemode established when calling RSEF wiii be used as 
defaults for later FILE, and SAVE commands. The filetype and 
filemode will be used as defaults for later GETFILE 
commands. 


CMS files, or if a DOS SYSRES is used, members from private 
or system source statement libraries can be included via the 
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GETFILE command; but no modification of a DOS/VYS library 
member is possible since access to the DOS/VSE libraries is 
read-only. The GETFILE command Searches the R sublibrary 
only. 


Any display terminal supported by VM/CMS is required to 
execute RSEF. 


All input is translated to upper case before procesSSing. 
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The uSer invokes RSEF by entering following at his terminal: 
/RSEF 


He will be prompted for the name of a library member to be 
created or nodified, and for the password, if necessary. If 
this member exists, it will be the base for subsequent 
editing. Otherwise, a new member with the specified name 
will be created. VSE/ICCF ruleS and procedures for password 
protection will be followed. 


The filename and password thus established wiil be the 
defaults for subsequent SAVE and FILE commands. 


Members from the VSE/ICCF library, or from a private or 
system source statement library can be ainciuded via the 
GETFILE command. Members from a source Statement library 
Cannot be modified. Only the R sublibrary 1S searched. 
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The user enters the edit mode at the start of an RSEF 
session, with either an empty workspace or a workspace 
containing the file specified when RSEF was invoked. The top 
line of the source displayed on the screen iS known as the 
current line and iS identified by the current line pointer, 
which 1S an amplicit parameter for most of the RSEF 
commands, (e.g. DELETE). The location of the current line 
Within the workspace may be controlled by the user by means 
of the RSEF commands (described later in this chapter). 
When a command has been completed, the screen is refreshed 
with a display of the workspace contents starting at the 
current line. 


When the WocKkspace has been updated to the user's 
satisfaction it may be stored in the program library, either 
under a new name, or it may be used to replace the existing 
version of the progran. 


in WeNten in ste aan RATE LENG ALTER ALD CRED ED Wh 


The user may change from EDIT mode to input or alter mode by 
issuing the INPUT or ALTER commands. The purpose of these 
modes is to provide source entry and moditication facilities 
With a subsequent syntax check. 


When input or alter modes are entered, RSEF displays a 
template appropriate to the type of RPGII specification 
being handled, displays the present contents of the line 
being built or modified, and any error messages produced by 
the Syntax Checker. 


When the user indicates to RSEF that he is satisfied with 
the contents of the line, by pressing the ENTER key, RSEF 
passes the source line to the Syntax Checker for compliance 


With the RPGII syntax rules. 


If no errors are detected, the line is placed in the 
workspace, either by insertion (INPUT mode,new lines) or 
replacement (ALTER mode,modified lines). If erors are 
detected, the lane is displayed again together with as many 
error messages from the syntax checker as will fit on the 
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screen. 


The user may optionally request INBUI with prompt submode. 
This submode prompts the user for the fields of the chosen 
RPGII specification, in accordance with the RPGII syntax 
rules. | 


This mode has advantages for the inexperienced RPGII 
programmer, since the Syntax Checker ensures that mandatory 


fields are defined and that no conflicting fields are 
entered. 


This submode 1s provided to allow compile time array data to 
be entered without the Syntax Checker being invoked. 


The experienced RPGII programmer may wish to use this 
Submode to enter bulk code rapidly withort invocation of the 
Syntax Checker and then to uSe the SYNTAX command to syntax 
check the whole block of source entered in this way. 
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To assist the user in entering or modifying his source text, 
different screen formats are displayed depending on the mode 
of operation. 


1. Edit mode format: 


This display format is presented to the user at the start 
of a RSEF session. It is used for all commands except for 
INPUT (not for DATA), ALTER, '?*, and SYNTAX (in an error 
Situation) which have their own Special format. AS many 
lines of RPGII source text are displayed as will fit on the 
screen, a line of message data, and a redisplay of the last 
command entered. If there are less lines of RPGII source 
than the screen allows, an end-of-file indicator will be 
displayed | 


ROORKEE END OF FILE ** ®# 8k eR 


and the remaining lines blanked out. 


va Input/Alter mode format: 


In this format RSEF displays a template for the type of 
RPGII specification currently being entered or modified. In 
addition up to 12 error messages are displayed, together 
with the source line being built or modified. This does not 
apply to the INPUT Gata submode. 


3. Command menu format: 
RSEF displays a menu of the commands available in the 


current processing mode. This menu is displayed Whenever the 
help command * is entered. 
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All RSEF screen textS, messages, and prompting texts are 
modularized which means that World Trade countries wishing 
to provide native language texts for the various countries 
have only to modify these modules to the required language, 
and then link the RSEF anew. 
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DOS/VS RPG-II Release 3.0 Supports Fixed Block devices for 
SAM and VSAM files, and for compiler workfiles. The working 
files defined on FBA devices are specified by means of JCL 
Statements. Block size will be 4000 bytes. 


VSE/VSAN is a pre-requisite to provide access to VSAM 
datasets. The specifications for VSAM KSDS, ESDS and RRDS 
have not changed. | | 


The specifications for a SAM file requires ‘FEA’ to be coded 


in columns 40 to 42 (Device field, columns 40-46), of the 
FILE (F) specification. 


II SOURCE ENTRY FACILITY {RSEF) COMMANDS 


All commands consist of a command verb followed by one or 
more parameters, some of which may be optional. The optional 
parameters may or may not have defaults. 

Command verbs may be entered in two forms: 


(a) Full format, where all characters of the command 
are entered, (e.g. CHANGE ) 


(b) Abbreviated format, where an abbreviation is 
entered (e.g. C, CH, CHA, CHAN or CHANG for CHANGE) 


The minimal abbreviation for the command will be shown as 
alternative below the corresponding command verb. 


Parameters are Separated by one or more blanks. 
Parameters with alternatives are indicated by means of 


vertical lists and default values for each parameter are 
also indicated. 
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ALTER Command 


The ALTER command allows the user to modify the current 
line. When this command is used the altered line is passed 
to the Syntax Checker before it is stored in the work space 
(Compare with CHANGE command). 


The user will be shown a template which facilitates the 
input of the fields. By pressing the ENTER key he submits 
the line to syntax checking. The Syntax Checker will inform 
the user whether the source line is complete and 
syntactically correct, or not. To provide an optimum of 
information syntax checking of the source line may continue 
even after an error has already been found. However, 
subsequent error messages may be incorrect due to preceding 
errors. 


Any error detected will be indicated by an error message, 
and by a ‘'$' above (VM/CMS) or below (VSE/ICCF) the 
beginning of the erroneous field. Any entry not required 
for a correct source statement will be indicated by an 'S*. 
If there are superfluous entries, the original statement and 
the syntactically correct statement purged from the 
superfluous items will be displayed. The user then has the 
option to choose either the syntactically correct line (by 
entering 'Y*'), or his original line (by entering 'N‘'). 


If no syntax errors are detected and the line is complete, 
the new source statement will replace the current line in 
the work Space, 


fhe ALTER command processes only one line at a time - namely 
the current line. Control passes back to the edit mode 
display as soon as all alterations to the current line have 
been completed without a syntax error being detected. 

If the escape characters '?9Q' are entered in columns 1-2 of 


the input line the alter mode is terminated and ho change is 
made to the current line. 


ALTER 


Current line pointer: unchanged. 
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BACKWARD Command 


The BACKWARD command allows the user to scroll ‘n't (default 
15 1) screens backward in the workspace. No wrap-around is 
possible, and a BACKWARD command which scrolls beyond 
top-of-file points to the first active line in the 
workspace. 


BACKWARD 1 
B n 


Current line pointer: moved 1 or n Screens backward in file. 


The BOTTOM command is used to set the current line pointer 
to the last line of the current workspace. If the workspace 
is empty this command is ignored. 


BOTTOM 
BOT 


Current line pointer: set to the last source line in the 
workspace. 
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Use the CHANGE command to change a specified string of 
Characters to another specified string of characters of 
either the same or a different length. If the length of the 
new string is different, it will be either truncated or 
padded (with blanks). The command can only be used to 
Change the current line. 


No syntax checking is done for the resulting line. If syntax 
checking 1S required the ALTER command should be used, or 
the changed line should be syntax checked using the SYNTAX 
command. 


CHANGE delimiter stringi delimiter string2 delimiter 
Cc 


The delimiter character is defined as the first non-blank 
Character occurring after the command verb. Refer to the 
ZONE command for the search range of CHANGE. 


Examples of valid change commands: 


CHANGE /OLD/NEW/ NEW! replaces 'OLD* 
c *OLD*NEWNEW* NEW? replaces ‘OLD! 
CHANGE XOLDOLDXNEWX ‘NEW replaces ‘'OLDOLD! 


Current line pointer: unchanged. 
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The DELETE command is used to erase ‘'n'*' (default is 1) lines 
Starting with the current line. 


If '** ais specified, the current line and ail lines after 
the current line will be erased. If the DELETE * command is 
used to erase all lines in the workspace the current line 
will be set to top-of-file. | 


DELETE 1 
DEL 


* 


Current line pointer: set to line preceding the first line 
deleted, or to top-of-file. 


Used to move the current line pointer to 'n' {default 1) 
lines after the current line. If the workspace is empty 
this command 18S ignored. | 


If moving down 'n* lines will move beyond end-of-file the 
command has the same effect as the BOTTOM command. 


DOWN 1 
D n 


Current line pointer: moved 1 or n lines forward. 
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FILE Command 


Used to store the contents of the workspace in the VSE/ICCF 
library or onto a CMS disk. Resequencing will be done if the 
RESEQ command was issued before. | 

If no filename, filetype, tilemode and/or password are 
specified, the values established when calliny RSEF are 
assumed as defaults. 

Under VSE/ICCF the file will only be stored in the user's 
private library. No write access to PUBLIC or COMMON ETSS 
libraries 1s provided. 


If the workspace is empty, the FILE command is ignored. 


FILE filename password 


where the defaults filename, password are determined as 
described above. 


Password handling is according to VSE/ICCF rules. 


CMS/DOS format: 


FILE filename filetype filemode 


where the defaults filename, filetype, filemode are 
determined as described above. 


Current line pointer: not applicable. 


O84 /04/79 IBM INTERNAL USE 10.35 


Chapter 10.5 | DOS/VSE PLANNING GUIDE | 
PROGRAMMING FACILITIES Volume II - 2210-9826 


The FORWARD command allows the user to scroll 'n' {default 
value is 1) screens forward in the workspace. No 
wrap-around iS possible, and a FORWARD command which scrolls 
beyond end-of-file has the same effect as the BOTTOM 
command. 


FORWARD 1 
F D 


Current line pointer: moved 1 or n Screens forward. 
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GETFILE Command 


The GETFILE command 1S used to include, after the current 
line, sections of source programs which have been previously 
stored in either the DOS/VSE source library, the VSE/ICCF 
library, or the CMS libraries (plus their read-only 
extensions). The GETFILE command does not imply a syntax 
check of the included code. 


Either the whole file ora section of the file can he 
included. 


Under VSE/ICCF the member for incluSion may reside on a 
PRIVATE, PUBLIC or COMMON ETSS library or be stored in the 
private or system source Statement libraries. The search 
occurs in this order. 


Under CMS/DOS first the CMS libraries are Searched, then the 
private or system source Statement library, if attached. 


GETFILE filename password lo hi 
GET : 


The decimal nuwbers 'lo* and thi' indicate the first and 
last lines, respectively, which are to be included. If both 
are omitted, the whole file is included. If one number only 
is specified, it is assumed to be ‘lo! and the file from 
this line to end-of-file is included. If the specified ‘lo! 
limit is outside the program to be included, the GETFILE 
command 1S ignored. If the *hi' value is outside the program 
to be included, the program will be included up to the last 
line. 


CMS/DOS fornat: 


GETFILE filename filetype filemode (lo hi) 
GET 
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The decimal numbers ‘lot and "hit indicate the first and 
last lines, respectively, which are to be included. If both 
are omitted, the whole file is included. If one number only 
is specified, it is assumed to be ‘lot and the file fron 
this line to end-of-file is included. If the specified ‘lo! 
limit is outside the program to be included, the GETFILE 
command is ignored. If the ‘hi’ value is outside the program 
to be included, the program will be included up to the last 
line. The rigth parenthesis is optional. 


Current line pointer: set to the first line of the included 
text. | 


ORD TOTS ERD COED “ARETE OEE 


The help command '?* may be used at any time to display the 
command menu on the screen. The workspace is not altered. 
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INPUT Command 


The INPUT command is used to generate new RPGII source 
lines, and to automatically syntax check these lines, one at 
a time. The user indicates in the command which RPGII 
Specification type he wants to generate. He is then shown a 
template which facilitates the input of the fields. By 
pressing the ENTER key he submits the line to syntax 
checking. The Syntax Checker will inform the user whether 
the source line is complete and syntactically correct, or 
not. To provide an optimum of information syntax checking of 
the source line may continue even after an error has already 
been found. However, subsequent error messages may he 
incorrect due to preceding errors, 


Any error detected will be indicated by an error message, 
and by a ‘'$* above (VM/CMS) or below (VSE/ICCF) the 
beginning of the erroneous field. Any entry not required 
for a correct source statement will be indicated by an 'S*, 
If there are superfluous entries, the original statement and 
the syntactically correct statement purged from the 
superfluous items will will displayed. The user then has the 
option to choose either the syntactically correct line {by 
entering Y), or his original line (by entering N). 


If no syntax errors are detected and the line is complete, 
the new source statement will be added to the work space 
following the current line. 


Input mode 1s terminated by entering ‘'?0Q' in columns 1-2 of 
the input line, or by entering a blank line. The input line 
will be discarded. 


If the DATA parameter is specified the user enters the DATA 
submode. In DATA submode, each line of input, delimited by 
the enter key, will be treated as data. No checks are 
performed Since this mode is intended only for the purpose 
of defining input for compile time arrays. If this mode is 
used for entering RPGII specification statements, then any 
Statement entered in this way Should be checked for 
consistency by means of the SYNTAX command. 


If the optional parameter '?P* is specified (for other than 
‘*' and DATA) the user will enter prompt subaode. The 
prompt mode allows free format input; alignments or leading 
blanks can be ignored. By entering ‘'?R* in columns 1-2 of 
the input line the user can restart the prompting at the 
beginning of the specification. Previously entered fields 
will be redisplayed. 
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INPUT H ?P 
I F 

E 
L 
L 
C 
0 
NS) 
U 
/ 
* 
DATA 


Current line pointer: set to last line created successfully 
by INPUT. 


Use the LOCATE command to locate a specified string of 
characters in the source text after the current line. 


LOCATE delimiter string delimiter 
L : 


Current line pointer: set to line containing requested 
String, or will stay at the current line if the string was 
not found. Refer to the ZONE command for the search range of 
LOCATE. The delimiter is defined as the first non-blank 
Character after LOCATE. 
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The QUIT command is used to terminate the current session 
Without alitering the source stored on the library. Control 
is returned to the host system. When the workspace is 
discarded by means of the QUIT command, no resequencing will 
take place. Refer to the RESEQ command. 


QUIT 


Current line pointer: not applicable. 


Informs RSEF whether or not sequence numbers are to be 
inserted automatically in columns 1-5 of the source in the 
workspace before the file is stored in the library. The 
parameter 'n' is the Sequencing increment from ‘0! to '51',. 
fhe default is 10. 


If resequencing 18S specified, the sequence numbers in 
columns 1-5 will be updated before the file is stored 
(FILE, or SAVE commands). No resequencing will occur if the 
workspace is discarded by using the QUIT command. 


RESEQ 10 
n 


Current line pointer: not applicable. 
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SAVE Comman 


Used to store the contents of the workspace in the library. 
The command does not imply the end of the current session 
and control will not be returned to the host systen. 


Resequencing will occur if the command RESEQ was issued 
before. 


If no filename, ftiletype, filemode, and/or password are 
specified, then the values established when invoking RSEF 
are assumed as default. 


Under VSE/ICCF the file will only be stored in the user's 
private library. No write access to PUBLIC or COMMON 
VSE/ICCF libraries is provided. 


VSE/ICCF format: 


SAVE filenane password 


Password handling 1s according to VSE/ICCF rules. 


SAVE filename filetype filemode 


Current line pointer: unchanged. 
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SYNTAX Command 
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This command enables the user to syntax check lines of code 
that may have been included by the GETFILE command or etered 
in DATA sSsubpmode and therefore may have not yet been checked. 
The number of lines is given by the parameter ‘n' (default 
is 1). If * 1S specified, the current line and all lines 
after the current one will be syntax checked. 


If the compile time data indicator ('*** in columns 1-2) is 
encountered, RSEF will terminate the syntax check, and issue 
an information message. 


If an erroneous line is detected this line will be treated 
in the same way as if it had been entered in input mode, 
with the exception that the line will remain unchanged in 
the work space if the user guits. The characters ‘'?9' in 
columns 1-2 of the input line will end the SYNTAX mode. 


SYNTAX 1 


#3 


Current line pointer: will point to the line following the 
last line syntax cnecked. If the user guits the SYNTAX mode, 
the pointer will point to the line from which the uSer guit. 


TOP command 


The TOP command is used to set the current line pointer to 
the top-of-file line. This command allows the user to add 
lines in front of the first line in the workspace. 


TOP 
T 


Current line pointer: set to top-of-file. 
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UP Command 


Used to move the current line pointer ‘n* (default 1) lines 
before the current line. | 


If moving up ‘n't lines will move beyond top-of-file, then 
the first line of the workspace will be displayed. 


Current line pointer: moved from 1 to on lines to the 
begining of the file being edited. 


ZONE Command 


Used to restrict the search range of the CHANGE and LOCATE 
commands to the specified columns. Default values are 1 and 
80, respectively. 


Current line pointer: not applicable. 
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Error Messages on Terminal 


fhe compiler will generate an error cross-reference Summary 
(Compiler Diagnostics Summary), which can be output to the 
user terminal (SYSLOG), and/or to the compiler listing 
(SYSLST), where it will replace the currently provided text 
of error messages. 


For each error detected in the source code, the Compiler 
Diagnostic Summary will include: 


- the text of the diagnostic message 


- appropriate information to identify the 
source statement that originated the error 


The terminal display is output to SYSLOG and it is invoked 
Via the VSE/ICCF option LIST or CMS/DOS otion TERK. 


The output to SYSLST is requested via the VSE/ICCF otion 
LIST or the CMS/DOS option ERRS. 


In previous versions of the compiler the cross-reference 
information was provided by intermediate relational 
messages. These messages will be dropped in the nhew 
implementation, because their information iS included in the 
Diagnostics Summary. 


If the option NOERRS is specified, the SYSLST output is the 
Same aS in previous versions of the compiler, i.e. the 
relational messageS are put out aS soon aS the errors are 
detected and, at the end of the listing, the compiler prints 
out only the text of error messages, without cross-reference 
information. 


The Release 2 compiler outputs the description and _ the 
identifier of detected errors, but no cross-reference 
information 1S provided: the programmer has to browse 
through the listing to find out where the errors occurred. 
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This is not an adequate support for on-line debugging, were 
a more concise and complete description of errors is 
required. 


The new Support, by providing error cross-reference 
information, facilitates, in an on-line environment, 
immediate correction and recompilation of a program without 
need to wait for the hardcopy output. 


It also facilitates the programmer's task in a batch 
environment, by providing error information in a more 
condensed fora. 


The Compiler Diagnostics Summary provides,for each syntax 
error detected in the source code, the description of the 
error and at least one of the following types of 
cross-reference information: 


- system assigned statement sequence number 
- user statement sequence number 


- other reference data like name of file, table, array, 
or field where the error is detected 
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The Release 2 compiler uSeS system generated sequence 
numbers aS cross-reference between message number and 
program statement. 


This system sequence number is not adequate for online 
debujging, because it is generated dynamically: | 


- it does not appear in the source code 


~ it does not match with the system sequence number of 
previous listings of the program if this has been 
updated | 


The user can provide his own statement Seyuence number, 
which is much more reliable as reference number because it 
is available with the source code and is not subject to 
change from one compilation to another. 


This statement sequence number can also be generated 
automatically by using the RSEF online editor and therefore 
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it can be included in the source code with no programmer 
effort. 


In the Rlease 2 compiler, this user sequence number 158 
dropped after the initial reading of the source and 1s not 
available for display if the error is detected in a 
subsequent phase. 


In the new release of RPGII this user sequence number will 
be maintained for the entire compilation run and, upon 
error detection, collected with other error information that 


will be displayed, at the end of compilation, in the 
Compiler Diagnostics Summary. 


Formatting of terminal output 

The messages written to SYSLOG will be formatted to fit the 
terminal display line. 

The error message and cross-reference data will he displayed 


in the Compiler Diagnostics Summary, aS shown in the 
following examples: 


TLNO99 PACKED ENTRY IN POSITION 43 IS NOT BLANK FOR AN ALPHA FIELD. 
ASSUME BLANK. 


00377 ALPFLD 


ILN178 FACTOR 2 IS INVALID.SPEC IS DROPPED IF ANY ENTRY IS REQUIRED 


D 00234 10-120 CALL 
D 00288 11-023 PARM 


Note the 'D' indicates that the two statementS have been 

dropped. 

ILNO71 RAF/TABLE/ARRAY FILE HUST NOT BE A KSDS. SPEC IS DROPPED. 
D 00330 01-022 ITAB OTAB 

The error message is followed by a line of cross-reference 

data for each occurrence of the error. The cross-reference 


data displayed is the information available when the error 
is detected. 
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The cross-reference data iS shown in four columns as follow: 
~ first column: system seguence number 
~ second column: user Sequence number 
- third and fourth columns: nane of 
the elements (i.e. file, table, array, 


indicator, field, etc.) that caused 
the error 
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Compiling RPGYI Programs Under VSE/ICCF 


A VYSE/ICCF CLIST procedure will be provided for compiling 
RPGII programs under VSE/ICCF. This CLIST procedure is 
Similar to those available for other high level languages 
under VSE/ICCF. The parameters passed to this procedure 
define the compiler input and outputs. 


RPGII filename1 (OBJ filename2 options) 
* 


where filenanel (required) is the file name of the source 
progran. the other parameters are optional. If nothing or 
‘(OBJ *' ais entered, the compiled object program will he 
filed in the punch area under the name ‘filenamei*. 
'filename2' must be used to file the compiled object program 
in the library under the name ‘'filename2'. 


VSE/ICCF stores the object deck into a VSE/ICCF library if 
the parameter OBJ followed by a filename iS passed to the 
procedure which initiates the RPGII compilation. If the 
filename is replaced with '*' the object deck is placed in 
the user's puncn alea. . 


Note: An object deck is only produced if the option DECK is 
in effect. 


The SYSLST output under VSE/ICCF is directed to the user's 
terminal. The user can specify in adition the /HARDCOPY 
command to direct the output to a hardcopy printer. 


There are several options avilable under VSE/YICCF. Refer to 
the /OPTION job entry statement. Some Significant for the 
compiler are: 


DECK /NODECK Produces an object deck 
IST/NOLIST Produces terminal display 
LOAD/NOLOAD Enables automatic execution 


of the compiled object deck 
NOREST/RESET Stacks more than one object 
deck in the punch area 


Note: The options at the left side are the defaults. 
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Compiling an Auto Report Program Under CMS/DOS 


A CMS EXEC procedure is provided to invoke the Auto Report 
feature: | | 


RPGIAUTO filename (options 


were *filename* (only parameter required) is the name of the 
source program to be compiled, wich normaly has a filetype 
Of "RPGIAUTO'. The options supported are those indicated for 
the compiler. Depending on the punch otion in the 
Select/Sort Specification, the filetype can be 'RPGII'. 


Invoking the DL/I Translator Under CMs/DOS 
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A CMS EXEC procedure is provided to invoke the DL/I 
translator: 


RPGIXLTR filename 


were 'filename' is the name of the Source program to be 
translated, wich must have a filetype of "RPGII'. The output 
of this compilation is filed under ‘filename RPGII' and is 
ready for normal compilation. The listing is filed under 
‘filename LISTING’. 
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The Display Management System/CMS (DMS/CMS) is available to 
RPGIIT proyrams in the CMS/DOS environment. ODMS/CMS allows 
the programmer to define (in CMS) terminal panels, and to 
use previously defined panels in RPGII programs: he can move 
data from data fields in the panel to data fields in the 
program, and vice versa, he can modify intensities, position 
the cursor, sound the audible alarm, and he can add comments 
to the bottom line of the panel before it is displayed. 


The definition of a terminal panel is done by the CMS 
command CREATE. This 1S Supported under VM/370 Release 6 
With VM/BSE or VM/SE Program Products. 


The RPGII programmer invokes the DMS/CMS panel manager using 
the High Level Language (HLL) interface of RPG-II through 
the CALL, PLIST, and PARM Calculation Specifications. A 
Calculation Specification with the operation code CALL 
provides the ability to link to another program. Parameter 
passing is specified by PLIST (parameter list) and PARM 
(parameter) Calculation Specifications. | | 


For the convenience of the reader of this document the 


layout of the CALL, PLIST, | and PARM Calculation 
Specifications is briefly summarized 
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CALL is a Calculation Specification operation code whick 
transfers control to the Subprogram specified in Factor2 
field. An associated parameter list specifying the data 
which are to be passed to the subproyram can appear in the 
Result field. 


Col. -%-5 RPG Standard 

Col. 6 Cc 

Col. 7-17 RPG Standard 

Col. 18-27 Blank 

Col.28-32 (Op.Code) CALL 

Col.33-42 (Factor2) Required. | Alphameric literal 


containing the name of the program 
to be called. 


Col.43-4u8 (Result Fid.) Optional.Name of PLIST to be passed. 

7 If blank, the CALL statement must be 
immediately followed by the PARM(s) 
to be passed. A CALL statement with 
blanks in the result field not fol- 
lowed by PARM(S ) will be executed 
with no parameters passed. 


(Col. 49-55 Blank 
Col. 56-57 Optional. An RPG Resulting Indicator 
| 7 may be specified to be set on for an 
an error return from the called 
program. 

Col.58-59 Optional. An RPG Resulting Indicator 
may be specified to be set on if the 
called program returns with LR (Last 
Record Indicator) on. 

Col.60-74 RPG Standard. 


Col. 75-80 RPG Standard. 


A program can contain multiple CALL statements to the same 
Subprogram with the same or different parameter lists 
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specified. 


Upon return from a subprogram, execution continues at the 
first executable statement after the CALL statement. 


Linkage will be by address, so that the called Subprogran 
Will be operating upon the parameters actually located in 
the calling program. Upon an abnormal return, the parameters 
Will have been modified up to the point of the error in the 
called subproyranm. 


If the error indicator (Col 56-57) is not present in the 
CALL statement, an error return will cause execution of the 
user *PSSR subroutine, if present. If not, default will be 
the RPG-II system error handling convention. 


Tf a Program Status Data Structure (PSDS) is specified in 
the calling program, it will contain a numeric return code 
upon return from a called progran. 


If the conditions for setting on the indicators in columns 
96-59 are not met, they will be set off. 
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PLIST Operation Code 


PLIST is a nonexecutable operation code which indicates a 
name by which a following list of parameters (PARN 
Statements) may be referenced by a CALL statement. 


Cols. 5d: RPG Standard. 

COln 6 C 

COls. 7217 Blank 

Col.18-27 (Factorl) Required. Name by which PLIST is 

referenced. Rules for RPG labels 

| apply. 

Col.28-32 PLIST 

Col.33-59 Blank 

Col.60-74 RPG Standard. 

Col. 75-80 RPG Standard. 


The PLIST statement must be immediately followed by the 
parameters (PARM statements) which belong to it. 
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PARM 185 a nonexecutable 


DOS/VSE PLANNING GUIDE 


code which indicates 
communicating with another prograa. 


Col,33=2 


Col. 43-48 


Co1l.49-52 


C01.53-59 


Col. 75-80 


The Result Field 
a Literal, 


name, 


O4/04/STY 


(Factorz) 


(Result Fld.) 


Positions) 


Chapter 10.5 
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Calculation Specification operation 
data elements which are to be used in 


RPG Standard. 

Cc 

Blank 

PARM 

Blank 

Reguired. <A field name, data struc- 
ture name, array element with cons- 


tant subscript, array name which 1s 
to be the parameter. 


(Field Length 
and Decimal 


RPG Standard, 
Blank 
RPG Standard. 


RPG Standard. 


of PARM statement may not contain a table 
a label. 
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Using The DMS/CMS Call Interface 


To call the DMS/CMS panel manager the RPGII programmer has 
to prepare the following Calculation Specifications: | 


Col.6 Col.18 Col. 28 Col.33 Col.43 

i | | | | 

c CALL "ILNEUDS! parmlist 
Cc parmlist PLIST 

c PARM . control 
Cc PARM loadi 

ce PARM loadn 

Cc PARM unloadl 
Cc PARM unloadn 
Cc PARM datamask 
c PARM textmask 
where: 
control is the name of a structure containing control 


information. The structure consists of the fol- 
lowing subfields (in the order listed): , 


panel eigth character field containing the name 
of a previously defined panel uSuing the 
DMS/CMS panel definition facilities, 


request one byte field containing the literal 'D' 
if the panel is to be displayed, or the 
literal ‘'R* if the panel is to be 
released. 


NOTE. The following parameters are app- 
licable to the display 'D' request only: 


rstatus is a one byte binary field which will 
indicate the key pressed in response to 
the display. In case of an I/O error it 
wil be set to a value of 255. 


Gataflds 1s a halfword containing the number of 


data fields in the panel. This number 
must be provided if doadlist, unldlist, 
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or dflmask are set to "Y* (yes). 


textflds is a halfword containing the number of 
text fields in the panel, including the 
comment, if requested. This number must 
be provided if tfidmask is set to 'Y'*. 


loadlist one byte field containing the character 
‘y*' af data is to be moved to the panel, 
else it contains the character ‘N*. 


unidlist one byte field containing the character 
‘y' if data is to be moved from the 
panel, else it contains a Character 'N'., 


dfildmask one byte field which contains the 
Character ‘'Y* if a data mask of at- 
tribute bytes is provided, else it con- 
tains the character ‘N*,. 


tildmask one byte field which contains the 
Character ‘'Y* if a text mask of at- 
tribute bytes is provided, else it con- 
tains the character ‘N°, 


comment 79 byte area which will be treated as a 
comment and will be displayed on the 
last line of the screen. 


signal one byte field.If this area contains the 
literal ‘"Y', the ardible alarm wiil be 
sounded when the panel is displayed. 


cursor halfword containing the number of the 
data field at whose beginning the cursor 
will be positioned. If the number is 
greather than the number of the data 
fields on the panel, the cursor will be 
poSitioned at the begining of the first 
data field. 


are areas in the program where data exists to be 
moved to the panel. The control parameter 
loadlist must be activated, and ‘n* must egual 
the value of the parameter dataflds. If no load 
parameters are passed, the data fields will be 
displayed as nulls or the fill character defined 
under the DMS/CMS Services. 


unload1i-unloadn are areas in the program where data is to be 
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moved from the panel. The control parameter 
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unldlist must be activated, and ‘'n* must equal 
value in dataflds. A shorter data entry will be 
justified. If no unload parameters are passed, 
all data fields will be protected, and data 
cannot be entered at the screen. | 


datamask is an array of one byte fields, one for each 
data field of the panel. If a byte is set to *0! 
the corresponding data field will be displayed 
at its previously defined intensity; if the byte 
is set to '1"', at normal intensity; if set to 
'2' at high intensity; if to '3', the field will 
not be displayed. The control parameter dfldmask 
must be activated if there is a datamask. If the 
datamask parameter is omitted, the data will be 
displayed at their defined intensities. 


textmask iS an array of one byte fields, one for each 
text field of the panel. The settings are the 
Same as for the datamasSk array. That is 'fO', 


1", 2°" or '3* for default, normal, high or 
dark intensity respectively. 


The control parameter tfildmask must be activated 
if there is a datamask.If the textmask parameter 
is omitted, the text fields will be displayed at 
their defined intensities. 


In case of an error, the DMS/CMS displays an appropriate 
eCIrror message. Also, a RPG resulting indicator which was 
placed in columns 56-57 of the CALL Calculation 
Specification will be turned on, and the *STATUS field of a 
Program Status Data Structure (PSDS), if one was defined, 
will contain a return code. 
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The VM/Interactive File Sharing (VM/IFS) is available to 
RPGII programs in the CMS/DOS environment. It gives multiple 
transactions from interactive users the possibility to 
access and share common data stored in VSAM datasets. 
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The RPGII programmer invokes VM/IFS input/output services 
uSing the RPG-II High Level Languages (HLL) CALL interface 
which 1S summarized in the paragraph on VM/IFS. He has to 


prepare the following CALL and PARAS Calculation 
Specifications | 


i I 


© 
3 
pe 
™ 
tr 


‘RPGTIFS* plist 


Cc plist PLIST 
Cc PARK count 
Cc PARM | function 
c PARM pcb 
c PARM 1oarea 
Cc PAR ssa 
where: 
count is a fullword which contains the value '3' if no 
SSA parameter is passed, else it contains the 
value "4! 
function is a four byte field containing the literals: 
‘GU sf (Get Unique) 
*GHU ! (Get Hold Unigue) 
‘GN ! (Get Next) 
‘GHN * (Get Hold Next) 
‘ISRT! (Insert) 
"REPL! (Replace) 
*DLET® (Delete) 
indicating the action requested from VM/IFS. 
pcb Program Control Block (PCB) for this file. The 
PCB is a declared structure in the application 
interface; its address is passed to the applica- 
tion. The layout of the PCB is compatible with 
the DL/I PCB format. 
1oarea iS an input/output area in the calling program. 


For variable length records, the first two bytes 
contain the record length. 
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iS an area containing the Segment Search 
Argument (SSA) which holds the key for the 
reguested record. This parameter can be ommited 
for the function ‘GN '*'. The layout of the SSA 
is compatible with the DL/I SSA format. 


All numeric fields are in binary format. 


If the VM/IFS detectS an error condition it will set the 
Status code of the PCB accordingly. 


04/04/79 


IBM INTERNAL USE 10. 63 


Chapter 10.5 DOS/VSE PLANNING GUIDE 
PROGRAMMING FACILITIES Volume [Tf | Z2Z10-9826 


DOS/VS RPG-II Release 3 compiler and its object programs are 
designed to oprate on any IBM System that 1S supported by 
DOS/VSE with VSE/Advanced Functions. A minimum DOS/VSE 
virtual partition Must be available. For performance 
reasons, a Minimum of 24K bytes of real storage is 
recomended. | 


For installation of DOS/VS RPG-II, the DOS/SVSE Restore 
utility program and the DOS/VSE Maintain History Program 
{(MSHP) are required. 


VSAM users will require the VSE/VSAM Licensed Program. 


The online component RSEF requires VSE/ICCF under DOS/VSE. 
It requires an interactive partition of 140K bytes of 
virtual storage. 


DL/I DOS/YS (5746-X%X1) Version 1 Release 4 is required for 
database (DB) requests. The DL/I DOS/VS franslator requires 
a Minimum of 128K bytes in a virtual partition. 


CICS/DOS/VS (5746-XX3) Version 1 Release 4 is reguired for 
datacommunication (DC) requests. The CICS/DOS/VS Translator 
requires a minimum of 128K bytes in a virtual partition. 


a) cae ent aie A aCe AER ROLTIN SARAERCD WEEE EY WEROCEES AGIETI TRESS SAREE SORES RED LD 


DOS/VS RPG-II Release 3 compiler and its object programs are 
designed to operate on any IBM System that is supported by 
VM/BSE 1.2/CMS with a DOSLIB. 


DMS/CMS and VWM/IFS CALL interface users will require the 
DMS/CMS and VM/IFS Licensed Products, wich in turn requires 
the VM/370 Release 6 plus VM/BSE or VM/SE Licensed Products. 
The online component RSEF requires VM/BSE 1.2/CMS. The 
virtual storage requirements for RSEF under CMS are 140K 
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bytes. 


The RPGII Compiler Release 3.0 under cCMS/DOS does not 
require the presence of a DOS/VSE SYSRES since the compiler 
does not copy poooks from the System Source Library. However, 
the CMS/DOS DOSLIB must be available to support the RPGITI 
Compiler and the RPGII object programs. 


The RPGITI Autoreport feature requires the presence of a 
DOS/VS SYSRES if the /COPY feature is used. 


The DL/I DOS/VS and CICS/DOS/VS Translators requires the 
presence of SYSRES. 


COMPATIBILITY WIT 


Source programs written for the DCS RPGII Compiler or for 
the DOS/V¥S RPGII Compiler Releases 1 and 2 will be accepted 
without any modification by the DOSyVS RPGII Compiler 
Release 3.0. 


Object programs uSing the Formatted Dump facility will run 
if the core image library contains the appropriate transient 
routines: 


~ Release 


1.0 object proyrams require 
Release 1.0 


Formatted Dump routines. 


~ Release 2.0 object programs require 
Release 2.0 Formatted Dump routines. 


- Release 


3.0 object programs require 
Release 3.0 


Fotmatted Dump routines. 


The DOS/VS RPG II Compiler accepts, without modification, 
source code programs written for the DOS RPG II Compiler 


By means of a Conversion Pre-Processor (CPP) Release 1 
(5735-CV1), batch source application programs written for 
the System/3 Model 10 Disk and Model 15 RPG II compilers 
(5702-RG1, 5704-RG1), are converted to a form acceptable to 
DOS/SVS RPG-II. 


The Auto Report feature iS an integral part of the DOS/VS 
RPG II Program Product. | 
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| DEPENDENCY ITEMS | 
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UNIT RECORD Support. 


| 
| 
| 
| 
| 
| 
| 
| 
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| 
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Program Prerequisites | 
~ SORT/MERGE 


OND PARR ERD I EN OEE EID AER GUD CORED ED EE CUED AIRE BOURD SOR CURT OED 1EERD EBD CUERD CEM ED UN GED RUD WRN CE BUEN CUED SONNE) CEE ED EET ARNE CURRED ORE ANN (NA AE ON EE ED AOR AN CUED EY EE CE A SED OND AED AED Oni ER EP GE COED SE TEED ED FAD OE SERED ERD ER EDD TENE <P 


CRP 
CR 
CRP 
CRP 
MFCM 
CR 
CR 
CRP 
MFCU 
MFCU 


Printer] 

Printer] 

Printer] 

Printer] 

Printer] 

Printer devices 
Diskette I/O Unit 


REMARKS 


} (1) If the SELECT/SORT function of the AUTO REPORT 
program is required, SORT/MERGE 5746-SM1 or 5706-SM2, 
or an equivalent sort/merye program is required. 


(ii) If VSAM RRDS ADDROUT processing iS required, 
Sort/Merge Version 2 5746-SMH2 is required. 


| At least a card reader jor equivalent) and a line 
printer (or equivalent) are required. 


printer device 


device 
device 
device 


Also aS a 
Also aS a 
|} Also aS a 


printer 
printer 
printer 


| 
| 
| 
| Also aS a 
| 
| 
| 
| 


| 

| Any DOS/VSE supported device (forward read only for 
| device independent files). Work files may NOT 

| use tape. 
| 
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DASD Support 
= 2314 

- 2318 

~ 2319 

= 3330152 
+ 3333 
3330-11 

- 3340 

~ 3344 

= 3350 

~ 3310,3370 
VSAM files ONLY. 


eb Geet ae Gee wee eee eee eee wee Ce ae Oe ee Et 


‘|DATA MANAGEMENT Support 


| 

- ISAM | 
| KSDS, ESDS and RRDS 
| 
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Work files (SYS001,002) MUST be on SAME device type. 


Fixed Block module (FBA) disk devices for SAM and 


RE GE RED CEN ERD CER SEU RR ANDY RED COED UD CORD EE CED COED CED CER CHER REED OUND cen WD GD COND AirtD ND ED CRED FED <EUR CED VEND CORD CED GED ED A> OEP cD cme ED <i CP Oe atm ED ee Re ea a 


es wen gee dee queet Gem Geenlh cm cit Game auem eet anmeid Gah Gee 


feeeaes ene eeueiaae cade ig aakee an aed eaaaceamae 


NOTE : The Decimal Instruction Set is required. 
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SUPERVISOR GENERATION OPTIONS 


The following is a breakdown of the mandatory and suggested 
Supervisor parameters within the Supervisor generation 


macros 


| LOTAB 


SSS — 
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» 
*s 


REMARKS 


SYSFIL=YES If DASD or DISKETTE are used with device 


independence. 


| 
I 
| 


Oe | 


| 
fhe following FOPT parameters, recomended for DOS/VS, are 
Standard under DOS/VSE: 


4 


As required by VSE/VSAM (from NPARTS+#2 to 255) | 


PC=YES | Required 
TOD=YES | To use TIME built-in function 
VSAM=YES | If VSAM support required 
GETVIS=YES | Forced by VSAM 
| | 
ee ere ie Le er ee eg a at ere ee OS eee ee pore i 
I | i 
VSIZE=nK | AS required by the system when in 370 mode | 
i i 
sete SO ON cette ae St <A ~anete “aa Hea “Sith ttle wiht “atte caeee le SS SSS SSS SSS SSS eS See as ci ens esis cil ams Se “ia Ss Sah eae Sou ‘ete ta. | 
| i 
NRES=n | 
| 
i 


rn an Oi ne en en ee we ee ae eee a ee oe 
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19.3-3 EXAMPLES OF USE 


fhis screen 15 displayed when the HELP (?) command is 
entered from EDIT mode. EDIT mode 1S entered automatically 
when RSEF 1S invoked. 


Tne screen displays are aS shown below, With minor 

differences between VSE/ICCF and CMS/DOS. This one is for 

CMS/DOS. 

A ALTER ALTER DAPA IN SOURCE L LOCATE LOCATE A GIVEN CHARACTER 

B BACKWARD SCROLi BACK N PAGES STRING 

BOT BOTTOK MAKE LAST LINE INTO QUIT END SESSION WITHOUT 
CURRENT LINE ALTERING LIBRARIES 

S CHANGE ALTER DATA IN SOURCE RESEQ RESEQUENCE COLS 1-5 
WITHOUT CHECKING SYNTAX SAVE SAVE WORKSPACE IN LIBRARY 


DEL DeLeETe DELETE ONE OR MORE LINES AND CONTINUE 


D DOWN ADVANCE ONE OR MORE LINES SYNTAX SYNTAX CHECK N SOURCE 
FILE WRITE SOURCE TO LIBRARY T TOP GO BACK TO TOP OF FILE 

AND END SESSION. U UP GO BACK ONE OR MORE LINES 

y FORWARD ScerkOLL PORWARD N PAGES | IN THE FILE 

GET GETFILE INSERT SOURCE MEMBER FROM vA ZONE SET UP THE SEARCH LIMITS 
LIBRARY 

: DISPLAY COMMAND MENU 

I INPUT CREATE NEW SOURCE LINE 


| 
| 
| 
| 
| 
IN THE FILE | RECORDS 
| 
| 
i 
| 


A eee eee, LO en ee eC ne es, Lin een, See «eee ere eee Lene 5 


SD RAED CER RED CORD GANS COANE CE AEM WERED SARE CRANES ERED, NNN END) OOD SEND “ED GUINEA CANND. ORAS EY ERED GENE “EUR SAGO HEROD TOP venga Spam AANA “EE GOONS ARREARS NED AANAED PEED AONE BRAND MOTTE. AED AREY LAER: CARAT. AREY SOUND ERLE IE ROIS ATER TED OED ENG OR CONS GONE GOOEY AD SOE FORD ERED SEAN AY NE ED AE CA ED: NE EEE COND ED ED LAAT NOLES AOD. ENED CED 
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EDIT MODE DISPLAY 


The screen displays are as shown below, With minor 
differences between VSE/ICCF and CMS/DOS. This display is 
for CMS/DOS. 


CNTR SEATED AIEEE EIDE SGN ESE CIEE: POLE: ALEC. EL LIED SONY EL REE CED LELEDD: SLNOG: LELEES COE CLES ARLE CERN CGE HEN ERIE ERAT CUE (BCI 


ILNZ001 ENTER COMMAND (? WILL DISPLAY COMMAND MENU 


000008 1 J BOS B 
OOO18FINPUT IPE F 80 80 READ4O SYSIPT 
000301 | 8 29 NAME 
00040C 01 INVAMT ADD TOTAL TOTAL 72 
00050C 01 INVAMT ADD GRPTCT GRPTOT 72 


OOO060COUTPUT H 181 1P 
* * *& * & & * * * END OF FILE * * * © *& & HOH Ok * 


A Sey er en! ee, Le, Se, Te | en, ee, ee re «ek MEE, Ament ene 


input o 


The top line is the 'message line*. For VSE/ICCF this line 
Will be at the bottom of the screen. The mesSsage numbers 
have the format *‘ILNxnnn' where: 


- nnn is the message number suffix 


- x is either 'Z' (indicating a general message) or 
a specification type (e.g. H,F,E,1,1,C,0) where 
the error has occurred 


The first line after the ‘message line’ is the ‘current 
line’ to be handled by the RSEF commands. 


The last two lines are the ‘command line’ and the ‘scale 
line’. In the example the INPUT command 1S issued to enter 
an OUTPUT specification under control of the Syntax Checker. 
The proper template will be displayed next. For YSE/ICCF 
both lines will be at the top. | 
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Tne screen dispiays for tha CMS/DOS environment are aS Shown 
below. In the VSE/ICCF environment the message and input 
lines, i.e. the top line end the bottom lines, exchange 
their places. 


TLNZ052- INSERT A RPG IIL LINE OR “ENTER 20. (COL 1- -2)_ TO. QUIT. INPUT MODE | 


LPO ae OE RNG Set EE TE ER STEELE EEE Se ele Te PO  nralitanndliivacnadiinenanditieseadidavcaliitanansdienmasdnameditiacretinenasttamdimanetiommtteesmtieensetitamsctiitss-etpuncediin emtinncoditenndimavedtinsscatiizenctiranrditosndigwrsetiiarecetiamadiiber~etnaaeinnerdiiasedgonediguendbtprnedieatbeemlgaanadbaanadtondiarstibreadiibewaadl 
ORD enh mR RON aC cme en SAUD ee SRY mA URS SOND ARENDT cenfmly MAN WO OS GIN OED CURE ERD OEED WRNR WAURED “ID ORR “CRIED COMERS GUIRY ARE COR SAWERD . eyyD “SNOT LONE LEN mM OMEN <meemll Ahm ORD URI ARS REY ID OUND AED “RIM OLED OD RNS “WARES VENI OUND RGN? WAI GRD VD SE SCRE SOD CUNY SURI ERE VRE WD OUND UN CED AONE ANNED NE wee <i conte wee dete 


A = PAGE/LINE K = NOT (N,BLANR) 

0 =0 L = FIELD NAME / *AUTO 

B = FILENAME M = EDIT CODE(1-4,A-D,J-M,X,Y¥,Z, BLANK) 
C = TYPE (H,D,T,E) N = BLANK APTER (B,BLANK) 

D = STACKER# (1-5, BLANK) /FETCH (F) P = END POSITION IN OUTPUT RECORD 

E = SPACE BEFORE (0-3,BLANK) Q = OUTPUT DATA TYPE (P,B,L,R,BLANK) 
F = SPACE AFTER (0-3,BLANK) R = CONSTANT OR EDIT WORD 

G = SKIP BEFORE (0-12) S = PROGRAM IDENTIFICATION 

H = SKIP AFTER (0-12) T = ISAM (ADD) / VSAM (DEL) 

I = OUTPUT INDIC. (BLANK,01-99,L1-L9, U = AND / OR 
HO-HY,U1-U8,0A-OG/OV,MR,LR,RT, 12) 


| ncsndieastbinanadiesnedinnsentimenndterevetitnancediamentnnn medinatentiearatingsdtinnendineEperuttinarnedipesditinmndtirsaditipeadiionsedtnaasalttinesdianattinarditmamdtimsath manatee tanned gnalimndtitnaatbnpseditnrandinpantditiansedtiartitanadtitirradinan: dikgendnnandiasediteanmtititesUtyarditremettanentineadingrdgnanttbiynedprenditennnigepanliandypnrimen tented tetlbianntpen iigriipreadprneedgeendrerdipemdpmpnstipsentiin aipaigendipaaed 
OE eee RY AEE RRND SURNE RERND YORE “ORD “WOOT <UEIED —AGED IN RANE ER Re <a eRe Aten naka Sa OE mR ORS GEN CRIED ND AD <ORUD COUEMD HRIERD catEm® © WNAAD GIPMUD “Ante CUDNEY AUIS wecetie yam “WAMlOy =etinn RI SUING “RUT Cm CREE neu GOERS CRM URED (Ra AE SUMED OUND GONRET SUNS AID CRUE CED GOMES LOMA WARN “OUND WOMAN “CURED SOO OD /ARE AOE OAD A SERRE OMI CUED SEND ON nD delle =D 


[TT 
UUU 
O C EGG KIT KIT M PEEP RRRRRRRRRRRRRRRRRRRRRRRRRR 
AAAAA BBBBEBEBBB D F_ HH KIft LLLLLLI N 6) oie ek Dee 
07150Cfilel 99n99n88 fieldi b 


eS, ee Eee, Le ee! eee eS en, Ae ae! ee. es OPEN, Lees eM, Nera ae amon, eee emma 5 
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O0AAD inane enmth eli eaNED annee ere AMAA SOS SS END “MELEE NED ARR SRNL Seen. nD ase 


ILNZ052 INSERT A 2PG II LINE OR ENTER ?Q (COL 1-2) TO QUIT INPUT MODE  }— 


Smsenedlp endian enedlipead nadine tanned prendiasiedianantenttheadisarcteltpssedinedieeeredyeauttinneatinbantiaeeedipncelpapecedgeaalitenedgeedtamnelmnediassnedinnmnediomediguaadaendtteaatdaicen dipanndtenmadlltgnaditnalitteecditywredianncditnasscdannsaedliivnaudineesatitnemudnessdiiteveatittemenditnsndimecediinssedihenasditeaditaundlmenctivensatasnndineandimareditprartinzeadiinmnainassdinmnsdtinerscaltinameditnasalittandedinae-atpannatactiarenditasa-dinemedinaendionnand 
armas; wnttn <temte Niet (SEED unmNS TAIN TUNE SMRNRD OE ARNID <éeete WHR “WN “CUED GUUED LAUER. CUNY MONS AIR AR UAE UREN SENS GARRY SOUND OAEED CIN UNIT “ORNL WR CUIRD <OLAND SOWNi oti OA NRE OD ORR GATED “Way semeyh VeeRiD cenit Inn THORAN REI COU SOE AOMaRD SOUND AAD: UD NII OER AAD RET COND NY ED CURR “ORD REED AN IRD “AMD ED CEN URED CVD OURAN CCNY in VRE se -mmney mA wnt Auth ove 


A = PAGE/LINE G = INDICATOR SETTING (S,BLANK) 
H = H (HEADER SPECIFICATION) I = FILE TRANSLATION (BLANK,F) 
B = DEBUG/DUMP/DUMPF (1,BLANK) J = FORMATTED DUMP (BLANK,A) 
C = INVERTED PRINT (BLANK,D,1,J) K = RPG TO RPGII CONVERSION (1,BLANK) 
D = ALTERN.COLLATING SEQ. (BLANK,S) L = SYSTEM/3 CONVERSION MODE (BLANK,S) 
E = SIGN HANDLING (S/BLANK,1I,0,B) M = SUBPROGRAM (BLANK, 5) 
P = 1P FORMS ALIGNMENT (1,BLANK) N = CICS/DL/1 (BLANK,B,C,D) 
: P = PROGRAM IDENTIFICATION 
H FI J M 
ARAAA BUCO EG CK NPP PPP 
Hi 


~~ 


a slow Nees: Vale ere oat 2 wwe 6 wb orb ada eS Sore Ns $5552 sk ww oe wee oe oe ee ete 
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TLNZ052 INSERT A RPG TI LINE OR ENTER ?Q (COL 1-2) fO QUIT INPUT MODE | 


Siassapellenindalllatypdllimmseedll needled kavatdllnsselttmsnatlinpasdatedinaterdtsaselitmsattanaadttecedtimeandttanntmadittematttenendttameattnaatttenadttamattitansalinansalitten tite alitaaatitcesaltmanndiien nadine aiieneadtittensiite iti atiKen tematic telitandltnes atten srt nsn tanedtitn a Blenaliie: dine a aedll nella Et Ditonselennatitess: Eiensntitionattmnaliomsdtimas alte nattiendiiomadtiansediiie ne: tiemunditaranttonaudittmmalitenntitmametiemetinaaadiion ntikenndinenadiieandtinmad 


ot cement SEN SED cate at mtn re atte Mine em Date AE AU ARE IRD CED em MEIN «En | mt Cm +N gu ue “nei th MRD “oem SOS ime me ENON ees eminem (athe RD SGUED Smee | GREED PUTS RN Ce ED SEE Wu tens NI AR OD UD GED EID GAD “om Gre SY ERE to “OND 


A = PAGEB/LINE K = P/B/L/R/BLANK 

Es &E L = DECIMAL POSITIONS (0-9) 

B = 2REC.SSQ.OF THE CHAINING FILE M = SSQUENCE (A,D,BLANK) 

C = NUMBER OF CHAINING FIELD (C1-C9) N = TAE/ARRAY NAME (ALTERN. FORMAT) 
D = FROM FLLE NAME OQ = LENGTH OF ENTRY (1-256) 

F = 70 FILE NAME P = P/E/L/R/ BLANK : 

G = TABLE OR ARRAY NAME Q = DECIMAL POSITIONS (0-9,BLANK) 


NUMB.OF ENTR.PER RECORD (1-999, BLANK) R SEQUENCE (A,D, BLANK) 
NUMB.OF ENTR.PER TABL/ARRAY (1-9999) S COMMENTS | 
LENGPH OF ENTRY (1-256) T PROGRAE JTUDENTIFICATION 


neno-edllipnmentidemnalinpmmedimandntaredllanmedinprinad emedteetedl nenedlinamatl pated ancdinpatandteaendtaredtimeadinssdltaadtsadtinanadtinesallitmmeditimaaliiennditemndtbmedisemdtiancdtttmemlittcmalttenndivamnsditnenditice sada dittenaditersatitonadtmanalitnonndiinsstthoandthasaaiiine: atkhaadiinandiiteesatimsntiimanediiivan stesso s.ctiitss.sthee acttensentagmatinnadiimnsttimasatiaanadiiinrndibnn adittncetiian aalttemantiinendimeaseliiensaditenseadiionasaliitenndlannatiitne natine.cctitensadiie nadie’ 
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6C33-6028- 
GC33-6029-1 
GC33-6030-2 


GC21-75 14-2 


SC33-6032-2 


GC33-6074-0 


SC33-0085-0 


S$H12-5411-4 


$C33-6031-2 


$C33-6034-1 


$C33-6033-1 


$C33-6035-0 


GX21-9090-3 
GX21-9091-2 
GX21-9092- 
GX21-9093-2 
GX21-9094- 
GX¥21-9095- 
GX21-9129- 
GX21-9139- 
LY33-9062-2 


SC33-6068- 


10.74 


Design Objectives 
Licensed Program Specifications 
General Information 


Introduction to RPG-II Report Writing 
Recomended aS introduction. It is application oriented, 


Installation Reference 
User's Guide 


CICS/DOS/VS Application Programmer's Reference Manual 
for RPG-II 


DL/I DOS/VS Application Programming Reference 


DOS/VS RPG II Language 
plus TNL SN33-9256 


Auto Report Feature 


Messages 


plus TNL SN33-9257 


Systen/3 Conversion Preprocessor Installation and 
Reference Manual 

plus TNL SN33-9258 

Output Specifications 

Extension and Line Counter Specifications 
Control and File Description Specifications 
Calculation Specifications 

Input Specifications 

Indicator Summary 

Debugging Template 

Auto Report Specifications 

Logic Manual 


VSE/Interactive Computing and Control Facility 
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Terminal User's Guide 


GC20-1818- IBM Virtual Machine 


Facility/370 


CMS Command and Macro Reference 


GC20-1819- IBM Virtual Machine 
CMS User's Guide 


GC24-5197-0 IBM Virtual Machine 


Pacility/370 


Facility/370 


Display Management System for CMS 


General Information 


SC24-5198-0 IBM Virtual Machine 


Facility/370 


Display Management System for CMS 


Guide and Reference 


LY¥24-5206-0 IBM Virtual Machine 


Facility/370 


Display Management System for CMS 


Logic 


GC24-5195-0 IBM Virtual Machine 
VM/iInteractive File 
General Information 


SC24-5196-0 IBM Virtual Machine 
VM/Interactive File 
Guide and Reference 


LY24-5205-0 IBM Virtual Machine 
VM/Interactive File 
Logic 


Facility/370 
Sharing for CMS 


Facility/370 
Sharing for CMS 


Facility/370 
Sharing for CMS 


BO- 03-78-01 RPG-II and VSAM-KSDS Yariable Length Records (WTSC 


Boeblinygen April 17, 


1978) 


BO-03-78-03 RPG-II and VSAM Sample (WTSC Boeblingen April 17, 1978) 


BO-07-78-03 RPG-II Batch to Online Conversion Guide (WTSC Boeblingen 


September 29, 1978) 
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10.6 FORTRAN IV LIBRARY OPTION 1 (3746-183) 
Status : : Program Product 
Latest Release :. 300 
Announced 2 1/79 
Planned Availability : 1/80 
Manuals Available : Licensed publications will be 
updated. 


Current user will automatically 
receive them plus a memo to uSers, 


SIPO's Available : No 
Selected Product Line : No 
Installation License : N/A 


Pre-Installation Test 30 days 


Central Service until discontinued 
upon 12 months written notice. 


Program Services 


ae 


Local Service at no charge until 
12/31/79 then Local Licensed 
Program Support. 
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This modification to Release 2 of the DOS FORTRAN IV Library 
Option 17 Release 3.0 will give users of DOS/SVSE with 
VSE/Advanced Function Release 2 access to Fixed Block disk 
devices through DOS FORTRAN IV. The rest of the functions 
have not Changed from the Release 2. For instance, the I[/0 
Support 1S equivalent to that available with Library Option 
1 Release 2: | 


- 2560 Multi-Function Card Machine 
- 5425 Multi-Function Card Unit 

- 3505 Card Reader — 

= 3525 CcardPunch 

~ 3410 Magnetic Tape Subsystem 

- 3420 Magnetic Tape Subsysten 

- 3330 Disk Storage Facility 

~ 3340 Disk Storage Facility 

~ 3330-11 Disk Storage Facility 

- 3350 Disk Storage Facility 


- Improved tape and disk utilization with larger block 
sizes 


- ASCII magnetic tape standards for interchange of data 
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Four important points should be noted : 


(i) Library Option 1 is required for object time Support of 
the 3330, 3340, 3350, 3330-11, and Fixed Block devices. 


Support of the Fixed Block disk devices requires the 


device support provided by the DOS/VSE with 
VSE/Advanced Functions Release 2. 


(ii) Fixed Block device support provides support for user 
sequential data sets. Direct access data Sets are not 
Supported. 


{111)DOS FORTRAN IV Library Option 1 Release 3 will provide 
the same support for I/O devices provided by Release 2 
on DOS/VS Release 34 and will run on DOS/VS Release 34. 
The Library Option 1 can be used to 
The Library Option 1 can be used to provide ASCII 
Support of System/360 and System/370. 
(iv) The Library Option 1 requires: 
- DOS FORTRAN IV Compiler (360N-FO-479) 
~ DOS FORTRAN IV Library (360N-LM-480) 


These Type 1 components must be ordered as part of the 
DOS Type 1 Tape (5731-AA1). 
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rogram Prerequisites 
- DOS FORTRAN IV Compiler (360-F0-479) 
- DOS FORTRAN IV Library (360-Lé-480) 


A CD CUD RD CED SD GRD SEED se Wen eee ED ete soem cam cD cup cnen GUD ERO ND wi seem em <0b eee Em ~<a Cate vam WER ee We se (ee 2 ee ce oe ee ee ce coe ee cm ee ee eee a ee wn ee ee ie ee ~<a ee Oe eo ee ap 


nit Record Support. At least a card reader (or equivalent) and line] 


- 3505 CR } printer (or equivalent) are reguired. 
= 3525 CP 
- 2526 MCM 
- 5425 MCU 
Printer 


! 
Wd 
NO 
na 
_— \ 


a: ah a. a an sem oe iD cw Cee se EP ae oe <a ae ~< ON fUt cm ee 08m ER ee ED CO ORD cate mm cee Ce tet tee “SE ee comin 1engmD FOND RED Rr conte 20m tam SEEDED em CO GD aie CAP eb <A we Whe ane CONn A ED coi OE ~<a cm eee 


ape Support 
~ 2400 series 
- 3410 


a ~~ ee ae ee we ee em we ee am ent ame oom a ER a ae ae 8a A ~<a qe <i Re ee ee cue <a ce ame ae ane em we SE a cme ae ee et cemD oe em ene 6 ee he ee ei i ena i ae ei a CR ee aD ie Ca ae atten A <i 


ASD Support 
mare eo 

- 2314 

= 3330 142 
- 3333 

= 3330= 11 

~ 3340 

- 3344 

- 3350 


- 3310,3370 FEA disk types for SAM ONLY. 


aD wee «el wb 4a aan ih ON Ot em Eh ee ea << ae ae ce ee cm <em were aw OR CE em ee ae em seme oem va cD ne ED 6 aR A ee eee ee eee ~<a 4 ee ee ee ee ee ee ee 


~_——e he ene att emt ee eee eee GP quem «ee eet Gee eek ee ae Gee set eee eet ewe Oe ee Oe ot GEE 


ata Management Support. 

- SAM | 

- DAM | Not for FBA disk devices. 

Ae cee cam ee nem came cme ue nem came wee me cen oem | ete ee meee ee te cee tee eee etree em eee Me nee One Rah aD ee ORD WOLD Mm NONI ED EOD ON we WR i “aD TOR OND AMD Wn LED LE WOR NN OE COMED nD HIS HI ANS WORN IRD WORD NS OY SO ne 
TE : The Floating Point feature MUST be installed on the CPU. 


The Decimal and Floating Point Instruction sets are required. 
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SUPERVISOR GENERATION OPTIONS 


The following is a breakdown 


of the mandatory and suggested 


Supervisor parameters within the Supervisor generation 

macLros ; 

Pi ee re eee ee sae pena a Fee ge ear OG etry eT Oe rg oe eee ae | 
| MACRO | PARAMETER | : REMARKS | 
aaa” aia a aa ea ete ete ee ec ag at aa as eee EE ie eee Oe eee a al ed rere ere ee i 
| | 
J]SUPVR | ASCII=YES | Only if ASCII support needed. | 
| ; I 
once See re her LG eg eet ee I ga TERE oe ge nee POS eee | 
| | | | 
{CONFG | FP=YES |] Required | 
| | | 
naa forage er ge se 0a ene ene eg net cena rae eg a ae any ea detec eg ee aN aE a | 
| | | | 
{[VSTAB | VSIZE=nk | AS required by the system when in 370 node | 
| | | 
| ------ |--------------- | moo on | 
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SC28-6883- DOS FORTRAN IV Library Option 1 
Programmer's Guide Supplement 


GC28-6882- DOS FORTRAN IV Library Option 1 
Program Product Specifications 


GC28-659b- DOS FORTRAN IV Library Suoprograms 
GC28-6397- DOS FORTRAN LV Programmer's Guide 


GC28-6515- IBM S/360 and s/370 FORTRAN IV Language 
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10.7 DESZCICSZVS-DOS (3746-XC4) 


Status 
Latest Release 
Announced 


Planned Availability 


Manuals Available 


SIPO's Available 


Selected Product Line 


Application Enabling 
Proyram (AE) 


Installation License 
Pre-Installation Test 


Program Services 


DMS/CICS/VS-OS (5740-x¢5) 


When no explicit mention to the 


oe 


1 


DOS/VSE PLANNING GUIDE 
Volume II 


ZZ10-9826 


Program Product 
130 
1/79 Releases 1.0, 2.0 and 3.0 


5/719 Release 1.0 
12/79 Release 2.0 
5/890 Release 3.0 


5/79 Planned for Release 1.0 


DOS/YSE SIPO/E (Plan.Avail. 3079) 
VM/DOS/VS SIPO/E (Plan.Avail.4(79) 


Yes (Replaces DMS/VS) 


Yes. The AE Program 1s designed to 
accelerate the customer application 
deveiopment process in intermediate 
and large accounts by re-emphasising 
techniques, products and Services. 
AE provides Executive Conferences, 
Customer Seminars and Workshops, and 
Team Studies. 


N/A 
30 days 


Central Service until discontinued 
upon 12 months written notice. 


Local Service at no charge until 
12/31/79 then Local Licensed 
Program Support. 


Same facilities as provided by the 
DMS/CICS/VS-DOS product.Were some 
differences arise they will be so 


indicated. 
OS of OS products is made, 
es to both. 
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Development Management System/CICS/VS-DOS replaces 
DMS/VS-DOS for DOS/VS and DOS/VSE. This program product 
Simplifies application development using the 3270 


Information Display System (IBM 3270 IDS). It aids in the 
design and generation of online application programs by 
providing a simple, still powerfull, interface to the uSer.. 


The Simplified application development and increased 
programmer productivity can be achived through the 
facilities already included in the DMS/VS-DOS Version 1 
Modification 1 and the new support and capabilities offered 
by the new DMS/CICS/YS-DOS Releases 1.0, 2.0 and 3.0. An 
exception to this is the support of DL/I-Entry wich is not 
incorporated in the new Proyram Product. 


DMS/CICS/VS-DOS is written in S/370 Language. The online 
components operates under control of CICS/DOS/YS (5746-XX3) 
Version 1.4 and subsequent releases unless otherwise noted. 
Thus, support of S/370 and 4300 Processors, and devices 
under DOS/VS and DOS/VYSE is provided through CICS/BOS/VS 1.4 
and its Independent Component Release (ICR). 


For the database user DL/I-DOS/VS (5746-XX1) Version 1.4 and 
its ICR will provide the proper support under DOS/VS and 
DOS/SVSE. 


Note that the ICR*'s mentioned above permits the access to 


Fixed Block type of devices, under DOS/VSE, for the FBA 


ED CAD OSE CHES eoneees rs ROME! ROR oe 


devices attached to a 4300 Processor. 


Since the batch components use VSAM, SAM and 
SYSIPT/SYSPCH/SYSLST device access, there is no 
incompatibility to process them under DOS/VS and DOS/VSE 
accesSinyg the Supported input/output devices. 


DMS/CICS/VS-OS (5740-XC4) operating under control of 
CICS/OS/¥S Version 1.4 (5740-XX1) plus the optional 
IMS/VS-DB product, offer to the OS uSer the Same DB/DC 
capabilities available to the DOS uSer. The very few 
exceptions to this rule will be noted at the proper places 
in the discussion that follows. 


The following line items highlight the facilities provided 
by both, iMS/VS-DOS and DMS/CICS/VS-DOS. 
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DESZVS-~DOS LINE ITEMS 


DMS/VS-DOS Version 1 Modification 0 (delivered by end 
1976). 


- DMS-II (vOS/VS) functions are preserved. 


- Formatted Terminal Data facilities for Post-Response 
and Pre-Display program exits written in COBOL, PL/I 
and Asseablier languayes. 


- DLI-DOS/VS and DL/I-Entry enhancements for inquiry, 
update/delete and add single or multiple segments 
(not repeated) from/to up to four databases from a 

panel. Windowing through a $RPT function to inquiry 
repeated segments of one type from one database only. 


~- Secondary Index access for DL/I-DOS/VYS and DL/I-Entry 
databases, and Alternate Index access to VSAM 
datasets. | 


- Program Function keys correspondences to Function 
Identifiers coded on the same panel. | 


- Global Target (&) panel exit for added security and 
independence in the design and code of panel 
hierarchy. | 


DMS/VS-DOS V1 M1 PTFO001 (delivered by end 1978). 


- Performance enhancements reducing the number of CICS 
calls made by DMS/VS: | 


- panel loads and deletes are optimized. 


. CICS LINK, XCTL and RETURN macros are replaced by 
Branch-and-Link/Eranch instructions when control is 
transfered to/from the najory of the DMS/VS online 


modules. | 


DMS/VS-DOS V1 M1 PTFO0OO2 (delivered begining 1979). 
- Support of the additional Program Function keys and 


the various screen Sizes available for 3276 and 3278 
display terminals. : | 
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DESZEICS/VS~DOS LINE ITEMS 


DMS/CICS/VS-DOS Release 1. 


DMS/VS-DOS features with the exception of the 
DL/I-Entry support. Compatibility is preserved. 


DMS/CICS/VS is divided into two components charged 
separately: 


- BaSe Product 
» Aplication Generation Feature 


Central and Local Services provided by IBM Customer 
Enyineeriny. Local Service at no charge till December 
31, 1979. Then, Local Licensed Program Support is 
available to be provided by IBN Customer Engineering. 


DMS/CICS/VS-DOS Release 2. 


Calculations and edit capabilities to perform Simple 
arithmetics (add, Subtract, multiply and divide); to 
vaiidate fiels (move, compare/test, table lookup, 
de-editting and setting of attribute bytes); and to 
control operations (execute new function identifier, 
Worite-no-erase, terminate a transaction, etc.). 


DL/I enhancements to display repeated under repeated 
segments, and variable length segments. 


Add and Update files and/or data bases across 
multiple panels. This is provided for 
DMS/CICS/VS-OS under Release 1.0. 


DMS/CICS/VS-DOS Release 3. 


File ana data base Support through CICS/VS Inter 
Sistem Communication {I1SC) facility. 


RPG-II Command Level support of FDF (Formatted bata 
Facility). 


DMS/DBD generation from input supplied by the DB/DC 
Data Dictionary Program Product. 


Interactive Application Definition facility to allow 
for Data Definition, Panel Definition and Process 
Definition in an interactive, online environment. 
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10.7.2 PRODUCT FUNCTION 


Development Management System/CICS/VS-DOS is an Application 
Management Offering which Simplifies the implementation of 
online applications, using the 3270 [Information Display 
System. Use of DMS/CICS/YS can dramatically improve the 
productivity of application and system programmers 
responsible for implementing and maintaining online 
applications. This may reduce application design and 
implementation time from months if using BIAM or VTAM, or 
weeks if using CICS/VS Basic Mapping Support and Command 
Level, to days when uSing the DMS/CICS/VS approach. Ease of 
use of the DMS/CICS/VS precoded CICS/VS, , DL/I, VSAM and 
other functions makes this possible. 


DMS/CICS/VS facilitates the generation of an application, 
Via the Application Generation Feature, This consists of two 
stages. An Application Definition Facility and a Batch 
Application Generation. The first one helps the user to 
Specify the DMS/CICS/VS online and offline requirements of 
the application and puts these specifications into the 
Aplication Specification Library. From there, the second 
Will generate the tables to be interpreted by the 
DMS/CICS/VS online and offline components of the Base 
Product when the actual execution of the application takes 
piace. 


The Application Definition facility comes in two versions, 
offiine and onlane. The Offline Application Definition takes 
place through use of supplied fill-in-the-blanks forms. The 
Interactive Application Definition provides an online 
prompting Capability to specify the application to 
DES/CICS/VS. 


Pre-programmed facilities are provided for application 
selection, screen paging aad basic file and database 
operations such aS data entry, inquiry, update, search and 
browsing. 


One of the most important components of DMS/CICS/VS is the 
Display Mahagement Transaction, a set of Assembler modules 
that constitute an online application running under control 
of CICS/VS. This application creates panel images and sends 
them to the terminalis, receives responses and data from 
terminals and performs reguested functions. These functions 
Can be input/output operations ayainst files/databases 
followed by the display of reguired information on 
terminals. They may also cause the routing of messages or 
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screen contents to other terminals or, they may provide for 
some system Services, invocation of user provided routines, 
and so on. 
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PANEL DESCRIPTION TABLE 


GR MES ARE SN ater RRO AGT LAID AEN CRNEED ERE EE AS ON ea CEE: GEREN ERE RET 


To perform itsS functions, the Display Management components 
need tables which specify the data required and functions to 
be performed. | 


One of the most important tables is the Panel Description 
Table. This contains information that describes ;: 


(1) Layout and contents of a 3270 IDS panel screen. 


(ii) The files and/or databases to be accessed and the 
record and/or segment fields used. 


(111) The functions that the Display Management fransaction 
haS to perform, dependent on different operator 

p 

responses. 


(iv) Use of usSer written routines for Special cases, etc. 


(v) Calculations, validation/editting, control of flow 
based on special conditions detected. 


To build this type of table DMS/CICS/VS provides an offline 
Batch Application Generator utility called the Panel Table 
Description generator and a forn called the Panel 
Description Form to be filled-out by the user. An alternate 
to this fillinyj-in-the-blanks aproach is offered by the 
online Interactive Application Definition 


To code an online application using DMS/CICS/VS, the user 
must fill out this form with the specifications of his 
application design, have the form converted to 80 column 
card images and then process it with a Batch application 
Generator utility, which will convert it into a Panel 
Description Table. Once a set of panels has keen processed 
in this way, the application (or part of it) is ready to 
test. To do this, the user signs on under CICS/VS, then he 
keys in the transaction ID (for the DES/CICS/VYS Display 
Management transaction) followed, by the panel ID of the 
first panel in the application Sequence and one of the 24 
security key values (01 to 24) associated with the user 
Sign-on for CICS/VS. 
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This tirst (Main Menu) panel is displayed, and the operator 
at the terminal is able to work with a new application coded 
in a short period of time. Modifications during testing and 
Maintenance along the iife of the application, follow the 
Same productive approach. Documentation for the application 
is done mainly during filling out the forms and thus it 
becomes an automatic by-product of the DMS/CICS/VS 
application design/specification/codeytest cycle. For a list 
of DMS/CICS/VS precoded functions, refer to the General 
Information Manual. 


An alternative to this filling-in-the-blankS aproach is 
offered by the online [Interactive Application Definition 
facility. 
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Up to four files/databases may be accessed per panel. All 
the files supported are fixed length records within blocked 
or unblocked data sets. Organizations and file processing 
functions supported, are ;: 


(i) SAM, Sequential files 


Online : - supported as extra-partition data 
sets for input or otput but not 
Simultaneously. 


- INQUIRY, retrieving next record. In 
sequential processing is possible to 
display one or more records in a 
panel and also to produce several 
panels to display these records. 


- DATA ENTRY, entering next record. 


Offline : ~- INPUT, for updating or creating 
other file organizations (DMXUPDTE 
utility). 


- OUTPUT, for storing selected records 
from other file organizations 
(DMXPURGE utility). 


(11) VSAM-KSDS, VSAM Key Sequenced Data Set files 


Cnline ; - INQUIRY, retrieving selected records 
by key or retrieving next record 
once sequential processing is set 
(BROWSING). When in seguential 
processing, it ais possible to 
display one or more records in a 
panel and also to produce several 
panels to display these records. 


= UPDATE, of individual records. 

-~ DELETE, of individual records. 

- DATA ENTRY, of individual records. 
Offline : - INPUT, for selection of records to 


be logged to a SAM file (DMXPURGE 
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utility). The selected records may 
optionaly be deleted and logged. 


OUTPUT, for updates and additions of 
records from a SAM file (DMXUPDTE 
utility). 


(111) ISAM Indexed Seguential Access Method files 


Online 3: - 


INQUIRY, retrieving selected records 
by key oc retrieving next record 
once sequential processing is set 
(BROWSING). In sequential 
processing iS possible to display 
one or more records in a panel and 
also to produce several panels to 
display these records. 


UPDATE, of individual records. 


DELETE, of individual records. This 
1S not supported but it is possible 
to flag a record for deletion by use 
of the UPDATE function or via a user 
routine in an exit. The actual 
DELETE is accomplished through 
reorganizing the ISAM file. The 
OS/VS users may utilize the IEBISAM 
utility. 


DATA ENTRY, of individual records. 


Offline (only for DMS/CICS/VS-OS) : 


INPUT, for selection of records to 
be logged to a SAM file (DMXPURGE 
utility). The selected records may 
optionaly be flagged for deletion 
and logged. Actual deletion can be 
accomplished through reoryanizing 
the ISAM file using the IEBISAM 
utility. DMS/CICS/VS-OS only. 


OUTPUT, for updates and additions of 
records from a SAM file (DMXUPDTE 
utility). DMS/CICS/VS-OS only. 


(iv) DMS/CICS/VS INDEXED files 
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This 15 a special organization supported by DMS/CICS/VS, to 
provide rapid access and search capability for small, 
unordered, active files. In DOS, it consists of two VSAM 
ESDS (VSAM Entry Sequenced Data Set) files. One is the 
Index File and contains the key and optionally, selected 
fields of the data record which can be used aS search 
arguments instead of the primary key during inguiry. The 
second 1s the Reference File which contains the data 
records. In 0S, both files are implemented using Basic 
Direct Access Method (BDAM). 


Records in both files are in corresponding relative 
positions. Data records are always accessed through the 
index file. Once the index record is found, the 
corresponding data record is accessed from the reference 
file by means of the VSAM RBA (Relative FEyte address) 
calculated by DMS/CICS/VS-DOS or, the Relative Record Number 
calculated by DMS/CICS/VS-OS. It is important to realize 
that each access to the file is through the Index File, 
beginning at the first index record, until the required one 
is found. Then the Reference File can be accessed. 


Keys are unique but unordered in the file, and additions are 
made always at the end of the file. This type of file with 
a highly blocked index may be used for ; 


(a) Maintaining records that are not ready to go to a 
master file, suspense files, and 
(b) Highly active daily work files, exception files 
and other temporary files. 
The file processing function supported are; 
Online : - INQUIRY, retrieving of selected 
record by key. 
- SEARCH, retrieving of lists of keys 
or recordS using a search argument 
(may be generic) to be compared with 
the data in the Index File. 
- UPDATE, of individual records. 
- DATA ENTRY, of individual records. 


Offline : - Same functions as for VSAMN-KSLUS and, 
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- INITIALIZATICN, preformatting of 
Index and Reference files (DMXBI 
utility). 


(v) USER files. 


fhese consist of any file/database organization the user 
desires to access. The user has to provide a program to 
perform all input/output file/database and terminal online 
operations. He must provide for the offline Support also. 


(vi) DMS/CICS/VS GROUP files 


This is a special grouping of DMS/CICS/VYS Indexed files. One 
logical Indexed file may be divided into two or nore 
physical sub-files. A table containing the highest key 
values for every sub-file (Group File Table) is kept in 
virtual storage acting as a higher level index to speed 
access online. 


The availability of the file 1S increased because the 
failure of one sub-file does not affect the other sub-files. 
The online and offline functions supported are the Same as 
those for DMS/CICS/VS Indexed files. 


The SEARCH function can be used online to inquiry into only 
one sub-file at a time. 


USER files can be grouped. 


The OS user may group DMS/CICS/VS Indexed, USER, VSAM-KSDS 
and ISAM files. 


(vii) Data Base support 


DL/I data bases are supported by DSS/CICS/VS through DL/I 
DOS/VS. Logical relationships and secondary indexes afe 
supported. Up to four data bases and/or files may be 
accessed per panel. 


The OS user has the option to use the IMS/VS-Data Base 


Program Product to implement the corresponding DL/I database 
Support under CICS/OS/VS. 
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Online : - INQUIRY, for a single Segment or for 
multiple segments of different types 
and/or for repeated occurrences of 
Segments of the Same type, per 
panel. 


Repeated occurrences of segments may 
be displayed more than once using 
the Same panel image which can then 
be paged FORWARD/BACKWARD by the 
operator. (This is called 
WINDOWING in the DMS/CICS/VS 
terminology). 


Only one repeated segment type can 
be WINDOWED by panel in Release 
130% The retrieval of repeated 
segment types, including repeated 
under repeated segment types, is 
Supported under Release 2.0. 


~ SEARCH acts like INQUIRY to display - 


repeated segments of the same types 
but, a Search argument is provided 
for selection of segments. The 
output can be limited to a certain 
ammount of segments selected OL 
number of pages to be displayed. 


- UPDATE, a Single segment or multiple 
segments of different types, Release 
1.0. Under Release 2.0 the update of 
repeated Segments 1S Supported as 
well. 


-~ DELETE, a Single segment or multiple 
segments of different types. 


~ DATA ENTRY, of a Single Segment ofr 
multiple segnents of different 
types, Release 1.0. Under Release 
2.0 the addition of repeated 
segments is supported as well. 


Offline : - No support is. provided. 


In summary, file/data base support is as described above, 
and dependent upon the SAM, VSAM, DL/I and CICS/VS support 
for the type of devices required. | 
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TERMINAL SUPPOR' 


The IBM 3270 Information Display System devices are the only 
type of terminals supported by DMS/¥YS. A table, later in 
this section, Summarizes the available support. 
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DATA MANAGEMENT SUPPORT 


Apart from the input/output support indicated for files and 
data bases, the following data manipulation is handled by 
DMS/CICS/VS : 


(i) Online : 


- automatic conversion of file/database field mode 
to terminal character field mode and vice versa. 
File/database modes may be : 


. 'C', character (no conversion needed) 
. 'P*, packed decimal 

. 'F', fixed binary 

- ‘'X', hexadecimal 


- data editing and de-editing of numeric and 
character mode fields based on a mask selected 
from a table of masks. One table iS provided with 
OMS/CICS/VS. The user may extend/change this 
and/or create new ones. 


- data decoding. Through tables created by the 
user, the binary contents of a one byte data 
field, can be displayed on the screen of a 
terminal as a more comprehensive text (EXCLUSIVE 
TRANSLATE). A Similac facility permits the 
decoding of one/two byte/s data fields into one to 
eight/sixteen lines of text, depending on which 
bits are on in the data field (INCLUSIVE 
TRANSLATE). The opposite, that as the screen to 
file encoding iS not supported. 


(11)0ffline ; 


10.96 


- automatic conversion of file field mode, when 
uSing the DMXUPDTE utility for creation, addition 
or updating of a DMS/CICS/VS file from a SAM input 
file. 


- adding/subtracting numeric fields in a SAM file 


to/from the corresponding fields of a DMS/CICS/VS 
file (via DMXUPDTE utility). Replacement of the 
corresponding fields by the specified ones in the 
SAM file is also possible. 
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- no conversion iS provided by the DMNXPURGE 
utility since this produces only copies of the 
selected records from a DMS/CICS/VS file to a SAMA 
file. No conversion is provided by the DMXBI 
utilaty since this preformats the Index (with 
X'*FF*) and the Reterence (with X'00') files of a 
DMS/CICS/VS Indexed file. 
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USER WRITTEN ROUTINES 


For facilities not provided by DMS/CICS/VS, like data 
validation, special en-codiny/de-coding, editing/de-editing 
and calculations, DMS/CICS/YS provides interfaces and 
linking facilities to eassy the task of coding user 
routines. This user coding should be substancially reduced 
when in Release 2.0 CALCULATION OPERATIONS are used instead. 
The user routines may be coded in Assembler, COBOL or PL/I 
languages, uSing a common and standard approach for 
including CICS/VS and DMS/CICS/VS areas, record/segment and 
terminal input/output areas as dummy sections, and providing 
for addressability. In this way, although almost any 
CICS7V¥s Macro/Command can be used, the Application 
Programmer only needs to use the DFHPC TYPE=RETURN macro or 
the RETURN command of cCICS/VS to return control to 
DMS/CICS/VS at the logical end of the routine. 


For RPG-II the facility to generate the Formatted Terminal 
Data Area will be included in Release 3.0. Nevertheless, 
there is no present restriction to code user routines uSing 
RPG-{I CICS/DOS/VS Command Level interface provided the 
proper RPG-II OATA STRUCTURES and addressability are set. 
There iS one example of this in the chapter ‘Coding 
Examples! below. 


The different types of routines, in order of increasing 
difficuity to code, are : 


(1) FIELD LEVEL exit. When a field i5 moved from a 
file/database to the screen or vice versa, a user 
routine can be invoked to examine or modify the field. 


(11) PANEL and DL/I exits. User routines can be invoked 
at different points in time during the DMS/CICS/VS 
applications flow, like ; 


(a) (post-response) After a response from the 
terminal operator. At this point in time, the 
information entered at the terminal is available, 
and the fields from the panel may be addressed by 
Name in an area formatted by DMS/CICS/VS, instead of 
using the conplex terminal I/O area format. The area 
is calied Formatted Terminal Data Area(FTbA) and the 
functions are called Formatted Data Facility (FDF). 
The user may check data, make calculations, modify 
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data entered at a terminal, and decide further 
action like redisplay the panel with a saessage, 
perform a different function(as if the operator had 
given a different response), or continue normally, 
etc. 


(b) (pre-display) Prior to displaying the panel. 
The FDF facility may also be used to make 
Calculations and modify or check data that will be 
displayed. AS in the post-resSponse exit, access to 
the Terminal Input/Output Area (TIOA) or FTDA and 
decision on further action are possible. 


(c) (pre- read) PLiOL to a read from a 
file/ydatabase. At this point the key and, for a 
database, the segment Search arguments (SSA's), may 
be accessed for checking or modification, before the. 
read takes place. The user may code this exit to 
perform his own read access from a non-Supported 
file, and let DMS/CICS/VS to edit the data into the 
panel to be displayed. Further action as indicated 
to DMS/CICS/VS by the routine. 


(d) {(post-read) After a read from a file/database. 
The user may access the file/database 
work/input-—output atea containing the data which 
was read, and may address file/database fields by 
name and perform any desired calculations and 
editing of data, before the data is displayed. 
Further action as indicated to DMS/CICS/VS by the 
routine. 


(e) (pre-write) Before writing to a file/database. 
Data is available in the work/input-output area for 
further checking, calculation and modification and 
may be addressed by name aS in the post-read exit. 
File organizations not supported by DMS/CICS/VS may 
be processed by the routine at this time, but the 
complex movement of data from the terminal area to 
the file work area can be performed by DMS/CICS/VS. 
Further action as indicated to DMS/YCICS/VS by the 
routine. 


{£) (post-write) After writing to a file. At this 
point the user may check the status of the 
input/output operation. This is not available for 
DL/I DOS/VS databases. Further action aS indicated 
to DMS/CICS/VS by the routine. 
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(111) USER FILE PROCESSOR program. Standard cCiIcsyVS 
interface is provided for the user to write a complete 
I/O module to handle Special non-supported file 
organizations. The recommendation is to use the nodule 
DMXVP (VSAM-KSDS File Processor Model) as a model. 


(iv) CALL USER program. A complete CICS/VS transaction 
may be coded to be invoked by the operator at response 
time, to perform any desired function. 


(v) USER SUPERVISOR FUNCTION ainterface. A complete 
new module may be coded by the user and linkedited with 
DMXSM {(DMS/CICS/VS Supervisor Module), to extend the 
functions provided. 


In spite of the many alternatives offered, a normal 
installation can be implemented using only Panel and DL/I 
user exits and furthermore, the majory of the application 
requirements can be fulfilled by post-response, pre-write 
and post-read exit types. | 
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Apart from the Display Management transaction mentioned 
earlier, and supported by DMS/CICS/VS as well, ODMS/VS 
provides two other sets of modules associated with two nore 
transactions that operate under CICS/VS. They are : 


(1) Message Switching transaction, which allows the 
routing of messages, panel data and panel imageS among 
terminals. This 15 also provided by DAS/CICS/VS. 


{i1) File Rebuild transaction, which permits the 
reconstruction of files based on backup copies of files 
and sequential files containing changes logged by 
CICS/DOS/VS Automatic Journalling Facility or under oS 
by a facility provided by DMS/V¥S-OS. Eased on the 
current information avilable we may conclude that this 
function will be not provided by DMS/CICS/VS. 


No rebuild facilities are provided for databases. 
For them, the standard CICS/VS and, DL/I-DOS/VS or 
IMS/VS-DB procedures must be used. 


DESZEICSZVS OFFLINE CONPONENTS 


Apart from the various modules asSociated with the online 
transactions, DMS/CICS/VS provides six offline programs. 
Three of them are the Offline Application Definition and 
Batch Application Generation facility of the Releases 1.0 
and 2.0. (The Offline Application Definition will be 
enhanced by the Interactive Application Definition in 
Release 3.0. The other three are the Batch Utilities DMXBI, 
DMXPURGE and DMXUPDTE that were addressed before. 


The first ones are used to create tables which will direct 
the online activities of the DMS/CICS/VS Transactions and 
the offline activities of the Batch Utilities. 


The other three are used to create, maintain and update 
DMS/CICS/VS files. They operate with VSAM KSDS, ISAM {for 
DENS/CICS/VS-OS only) and DMS/CICS/VS Indexed files, but are 
particularly oriented to the latter files, because of their 
unigue DMS/CICS/VS format. 
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MINIMUM CONFIGURATION 


ED MED eign “BD BANS EOE MELT BREAD RED GS ERS EEE BGG ALLS TE OT ED NEE ATER CRD 


Any minimum DOS/VS or ODOS/VSE in a S/370 or 4300 
configuration supporting a CICS/DOS/VS partition, can be 
used to install, test and maintain DMS/VS. At least one 
3275/6/7/8 Display Station (local or remote) is needed to 
validate the installation. | 


The following figures may be used for planning purposes for 
a typical small configuration using 10 terminals and one 
transmission line. They do not include resources needed for 
other components like access methods, CICS/DOS/VS, DLy/sI 
DOS/SVS, etc. | 


| oe cae em Met sane tee en eee me WD Oem SOD atte SNP Ai Le SR GD We Si OD ene Ge ene SER ae ee ne a ete mee 
| DMS/CICS/VS Component 


| 
l 
| | Requirements | per unit 
| | Kilobytes | 
Ieee ee ee ee ee ee [a ee ear re iene ee 
| l ] 
| DMS/CICS/VYS Online Supervisor | 6 | 
| l 
] DMS/CICS/VS loadable nodules | 47.5 ; 
| | | 
| Transmission line buffer | 2 
| a l i 
{| DMS/CICS/YS terminal working | 15 | 
j storage | i 
| | | i 
| DMS/CICS/VS transaction work | 9 | 
| areas | \ 
| | I i 
| <cite> insti my emo: in sis‘ aoa chins ni smn‘ piss ins tin ei sei cess ce ] cane “600? COUP SOD SMD “tll SEED AED Atlin WENN ed Alle wie cot -unee = ene Mame ane ee Me mem Sete aN aan same atta ele cam 
| Total, in Kilobytes | 79.5 j 
| | 


| AED CURD NNR “ENED ENED SERED iti SUED AED GHD OHA AO EN CAND senna Gate GNIH AORN AEN COIN GARD WA SUD CEN << UD MEM <deD CE <n A oD 


If the DMS/VS-DOS File Rebuild module is used to reconstruct 
files using CICS/DOS/VS automatic journalling facilities, it 
occupies 6.7K bytes of virtual storage. The ODMS/VS-OS File 
Rebuild module occupies 2K bytes of virtual storage. 
Remember, it seems that the File Rebuild facility is not 
going to be implemented under DMS/CICS/VS. 
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2 per line 


Virtual Stérage |Addee onal Kilobytes| 


1.5 per terminal] 


I 
| 


9 per terminal| 


i 
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When a panel is accessing a DL/I database, the following 
dynamic storage is also needed (bytes) :; 


| sum of segment | | number of | 
500 + | lengths in the | + 178 x | Segments | 
| DMS/DBD _| j_accessed _| 


NOTE : DMS/DBD is the Data Base Definition block, Similar to 
a DL/I DBD but, it 1S used to describe to ODMS/CICS/VS the 
logical database record structure containing detailed 
description of fields within seyments. 


For planning purposes, the following figures for real 
storage (working Set) may be used (Kbytes) :; 


DMS/CICS/VS online Supervisor 4.6 
DMS/CICS/VS loadable aodules 26 
Transmission line buffers 2 per line 


Additional real storage fLrequirements are imposed by 
DMS/CICS/VS terminal working storaye and transaction work 
acreas, the access methods, cCICS/V¥S mdules and tables and 
DL/I modules, input/output butfers. Other applications and 
user written routines (as used in DMS/CICS/VS exits) must be 
considered as well. 


For more detailed information on Storage Lequirements, the 
reader is referred to the DMS/CICS/VS literature listed in 
the references, and also to the appropriate CICS/VS, DL/I 
and DOS/SVSE manuals. 
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DNS DOSZVS DEPENDENCY INFORMATION CHART 

[oe eee rig oer Gre Pe eer re ee ag ee ee FF OTT ee Nee oe TO GN TE | 
| DEPENDENCY ITER | REMARKS | 
[ee a i a a aa a a rere en og ae sao | 
|Program Prerequisites | 
li = ies sis | Required with Support for 3270. | 
| - DL/I DOS/SVS| Required to provide database Support | 
| - DOS/VS COBOL] Required to provide user exits in COBOL | 
| - DOS PL/I OPT] Required to provide user exits in PL/I | 
|} - Assembler | Required to provide maintenance and Assembler exits | 
| | 
| 


{| UNIT RECORD 
| suERere 


| sms west 0th cman stn seem etiee same win cams cabin eaten setae mime wom 
JTAPE Support 


Any DOS/¥S and DOS/SVSE supported device (offline). |} 
Any Utes supEortce oe ee | 


Any DOS/VS and DOS/VSE supported device (offline). | 
Any CICS/¥S supported device (online). | 


UD AERP ERD TED CED EE AN CE ND ED OD OE RD COE cae FRED Ante aaa «ele Celie AD ~<EED AOQUD “ERD CGRP 1ER CERRY CED CRD aD COE -aD SED SERN OE) AED BE <ED SA CD CY VORP COED on CUP A OU aD ea ED 


Any DOS/YS and DOS/YSE supported device (offline). 
Any CICS/VS supported device (online). 


age Support 

2311 

- 2314 

= 2319 

- 3330-1,2 

= 3333 

3330-11 

- 3340 

- 3344 

- 3350 

- 3310, 3370 Fixed Block Module devices for VSAM and SAM files 
and for DL/I databases. 


ee Se ee... Ue 


ARINP annie AER ~CERED cna CO pee NED cana wat senie a adie. ean Manet 


DATA MANAGEMENT Support 


<> comet ann ent anes anerth qty OR Ge OE pe dee oe Geen eee oan sitet gem am 


- SAM Supported as CICS/VS extrapartition data sets online] 
and as I/O for the Batch Utilities offline. | 

- ISAM Supported as CICS/VS ISAM data set online. 

- VSAM KSDS for inquiry, browse, update, delete, data 


{ 
| 
| 
| entry online and I/O for the Batch Utilities 
i offline. 
~ DMS INDEXED | Uniygue to DMS/CICS/VS consisting of one VSAKH ESDS 
| for INDEX and other ESDS for REFERENCE data. 
| They may be used for inquiry, search, update 
| and data entry online and, Input/Output for 
| the Batch Utilities offline. 
~ GROUP FILE | 
- DL/I bosyvs | 
| 
i 
| 
5° 
l 
| 


special grouping of DMS INDEXED with Same Support. 

For data base support of inguiry, search, update, 
delete and data entry online. No offline 
functions provided. 


-eannee “ahw ANAS “ND cela atm) URED “CNN ENEND nab “enteD eete WN Sm edinr MAES SAELD canst sODED ‘WAND UNNI OUND ein GUNES enti aM is SOND lthy “aig “ARE “abel “ARID ven tile eiiaie atte <td AANA GS SE atte ean ‘ali iti aap > a a ain ane A a 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


Gm ce we au Gee eet de> eo dee Gee ae eee Geen 


sae “ames aan wet ee ath ae i a a A a ae ee ote 


| CURRENT RELEASE 
l 1.0 


SED 


eevedyed Similar support as DMS/VS V1 M1 PTFOOO2 | 
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Compatibility Information 


(i) 


(12) 


(111) 


(iv) 


(v) 


O48 /04/79 


CICS/VS 


DL/I DOS/VS 


DMS/CICS/VS #ill be pregenerated under CICS/VS 1.4 
versions and iS Supported by follow on versions 
unless otherwise noted. 


DMS/CICS/VS has been reguested to be validated 
DL/I DOS/SVS Version 1.4 and subsequent ones unless 
Otherwise noted. 


DOS/VS and DOS/VSE Support is preserved as long as the online 


DMS/VS 


components of DMS/CICS/VS are accessing CICS/SVS 
datasets. The offline compatibility 1S preserved 
Since the offline components of DMS/CICS/VS are 
accessing VSAM, SAM and SYSIPT/PCH/LST datasets. 


No change iS required for operation under the new 
DMS/CICS/VS environment. Any existing DMS/VS user 


routine must be recompiled. Notice that the large 


screen support provided by DMS/VS-DOS Vi M1 
PPTFOOO2 forced a recompilation of any existing 
DMS/VS panel. 


DMS/DPPX, DMS/3770, DMS/3790, DMS/CMS and DMS/CICS/VS are very 


Similar in concept. However, because of the unigue 
requirements of the individual systems, there are 
incompatidilities among the DMS products. 
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SUPERVISOR GENERATION OPTIONS 


The following 1S a breakdown of the mandatory and suygested 
Supervisor parameters within the Supervisor generation 
macros ; 


ee <n CE ee ED <n a D cm 6 ae ee ee ae 


| SUPVR 
| 


TP=accs.method] BTAM or VTAM | 


teem 
Gama 
eae 


Presses 
' 
| 
| 
{ 
f 
i 

cee 


NOTE. The following FOPT parameters, recomended for bDOS/VS, are 
Standard under DOS/VSE: 
| 


a? 
© 
ae) 
a 


AS required by VSE/VSAM (from NPARTS+#2 to 255) | 
| | 


Cnn > Ae Ce em -en CEN ee cm SE <b HEN amb am ED 


{| PFIX=YES } If BAM runs in V=V mode. Forced by TP=VTAM. 

] GETVIS=YES |} Forced by VSAM. 

}| PCIL=YES | Support for Private Core Image Library. 

{| RELLDR=YES | Required 

| VSAM=YES |] Required for VSAM support 

| { | 
ieee odes [Sea Sea Sy ae aes aaa acer laa spn eee eng Re oe Sete eer ea eee ae ene | 
| i | { 
I¥YSTAB | VSIZE=nK | AS required by the system when in 370 mode | 
| | | l 
eae er ee ae Ge eee pag Seg en nT ee ee { 
| | | l 
JIOTAB | NRES=n | 

| { 

| | 


=. Se> 


NOTE >: See Chapter CIiICS/¥S for additional cIcs/v¥s 
requirements. 
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Supports only the IBM 3270 Information Display 


System, via local or remote attachments. ThiS is Supported 


Via 


normal CICS/VS Terminal Control. The following table 


Summarizes the supported 3270 components and features : 


onmm wet eee Gee Oe ee ee eet enh Gee ee Ge oe Geet Gee ee Gb oe ee ee seem eee ee eee eet 


Ee eee eee seed Geet Gee dete eee aie 6 ane 


NOTE: 
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TERMINAL 


ap Ce elite tan ai Ca CE in “a a <r ae ep 


a a ab ae ee eC ~~ ee ee Cote oD see 


a: “a Cp a ce se Cy <i ep -te “ae ee ae 
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REMARKS 
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Data Stream Compatibility (DSC) mode. Configuration 
Support Number 9165 and 9169). 


CD ORR “CURD TE GUD SA CED OED CRRRD AAD GREED URED AGED RD ND CGE AMNED Sil a “GN GRID AD wan CORD Sie Ct ~EEUD GP SUD AREY CURD COD EW GU Gu cup «ine age WEGRD <UNND AREND “UD Qui CUD AEE SEMP Qe GRD Wbr WD AEP SE aD ee a 


Remote Control Unit Models 1, 2,11,12. 
Local Control Unit Models 1, 2. 
L & R Control Unit Models 14,1B8,1C {SNA or BSC). 


—— <P “ee wen SP cm we te UEP sD nee see Cee Cm CE ate COR Ee stem <ene Cone SE ee Ce Ci ee HOR Se aie ~ce c em ch Cee <i Ce Sie cep ani Ae ee cD A “ae ee on ee oe i re eo 


Display Station Models 1, 2,11,12. 

Display Station Models 1, 2. 

CU Display Station Models 1, 2, 3, 4,11,12,13,14. 
Display Station Models 1, 2, 3, 4. 

Printer Models 1, 2. 

Printer Models 1, 2. 

Printer Models 1, 2. 

Printer Models 1, 2. 


Options as follows: 
- EBCDIC Transmission Code (#9761) 
- ASCII Transmission Code (#9762) 


-~ Keyboard Numeric Lock (#4690) 
- Selector Light Pen (#6350) 
~ Operator ID Card Reader (#4600) 
- Audible Alarm (#1090) 


Remote attachments via BSC or SDLC disciplines and 


provided through CICS/VS using the proper BIAM/VTAM 
Program Products. Refer to the CICSyYVS chapter. 
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40.7.4 DMS/VS-DOS FACILITIES IN DETAIL 


Changes have been made to reduce the number of CICS 
calls made by DMS/VS. These have reduced the path lengths in 


two general categories 


- Panel loads and deletes have been optimized. 
instance,there was the caSe where a Panel Table 
deleted and reloaded immediately. This has 
eliminated. 


For 
was 


been 


. New DMS/VS macros have replaced many cCICS/VS CALL 


macros. Logic has also been incorporated in 


the 


DMS/VS modules that reference them. There are three 


exceptions: 


- No change to the CALL's to user written programs. 


- No change to transfer of control between DMS/VS 


and CIcS/VS. 


~ Same few CALL'sS between DMS/VS modules have 
been Changed. 


These changes require that DMS/VS has access to 
online module addresses and hew register save areas 
link/return to/from the modules. The additional space 
provided from the Common System Work Area {CSWA) and 
Transaction Work Area (TWA) as follows: 


not 


the 
to 
is 
the 


~ CSWA size = 480 bytes. The first 256 bytes can be 
Shared with other programs. The last 224 bytes 
are of exclusive use of DMS/VS and must not be 
overlayed. This change may force some users to 
respecify the CSWA size and recompile the online 


programs that uses the Same area than DMS/VS. 
new DMS/VS modules are precompiled. 


The 


- CWA size = 980 bytes. The users have to modify 


and recompile the Program Control Table (PCT) 


to 


respecify the new CWA size. The DMS/VS user writ- 


ten routines must be reassembled. 
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The new DMS/VS macros Ceplacing CICS/¥S 
LINK/XCTL/RETURN macros put consistent entries to the 
CICS/VS Trace Table as follows: 


word 4 byte 1 trace identification code ‘pa 
id bytes 2 to 4 general register 14 value 
“2 not used by DMS/¥S 
care. DMS/VS module name not including DMX prefix 
nod function: LINK, XCTL or RTRN 


When the first DMS/VS transaction is Submited, it 
Will invoke either ODMXTI (franSaction Initialization) or 
DMXST (Message Switchiny). Either of these modules performs 
a one time load of all the DMS/VS online modules and builds 
a table with their names and addresses in the CSWA. To 
insure that these modules remain in storaye, the parameter 
LOADLST=NO is used. Then, Since the modules are not loaded 
again during the CICS/VS run, the user must not delete a 
module nor he can use the Master Yferminal transaction CSMT 
NEW,PGRMID=DMX... For a DMS/VS module.. 


T£ a module can not be loaded, tne message *DMS/VS 
MODULE DMX... NOT LOADED! is sent to destination 'CSMT* and, 
at the end of the loading process, the message 'ONE OR MORE 
DNS/VS ON-LINE MODULES NOT LOADED' is Sent to the initiating 
terminal. Since not all the modules are required for 
operation by different user environments, the lack of sSoge 
modules and the issuing of the correspondin Warning 
messages, do not preclude the use of DMS/VS. 
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DESZVS-DOS VI Mi PTFOOO2 


POR CED 


Changes have been made to support the additional 
Program Function Keys and screen s12zeS available with 
3276/3278 display terminals. Once this PIF is installed, 
all existing panel descriptions must be 
regenerated/recompiled. No changes are required to existing 
panels unless they are going to make use of the new support. 


Extentions made to the DMS/VS Panel Description Forn 
are the following: 


Display Description Card (type B): 


- Column 1, model of the 3276/78 display as follows, 


480 character model (compatibility mode) #4! 
1920 " " (compatibility mode) 42? 
960 9 9 *a?é 
1920 Th  E Bt 
2560 #3 +9 Le On 
3440 ? | 'p? 


- Column 76 should contain a '1* if a second Display 
Description Card foliows this one. 


Second Display Description Card (type B): 


- 12 Columns 60-71, space for the Function [Identifier 
to be associated with Program Function keys Nos. 
13 to 24, 


- Column 76 must contain a !'2'", 


Display Line Cards (no card type): 


- Up to 19 additional lines may be coded following 
line 24th ('0" in column 1). The code in column 1 
can be 'P' to 'Z* or, v.85 or tee, ty 4, tea, 
‘/*, '",*, or '?' according to the screen size of 
the 3276/78 model to be ased:; 


Lines 1-9 and A-C for 480/960 character 
" wg * Ajo. * 1920 sh 
" 9 © jew 2560 " 
" i-9 06" A-Z and .{*)3/,? for 3440 " 
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When specifying the CICS/VS Terminal Control Table 
(TCT) and the Program Control Table, the ALTSCRN (TCT) and 
SCRNSZE (PCT) operands must be coded for proper use of the 
2560 and 3440 character displays. 


This PTF have been preyenerated/tested using CICS/V¥S 
1.4. The number and importance of pre-applied fixes i158 
another reason for the users to install this tape. 
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DMS/CICS/VS-DOS RELEASE 1. 
(1) DNS/SVS-DOS features with the exception of the 
DL/I-Entry support. Compatibility is preserved. The 
precoded Supervisor Functions implemented are: (This 
functions are explained in the DMS/VS and ODMS/CICS/YS 
General Information manuals indicated in the literature) 
Display Control Panel Overlay vA" 
Panel Link ES 
Page Forward de 
Page Backward “oo 
Redisplay es 
Panel Return Te 
Database Operations Inquiry 'G? 
Inquiry for Update G3! 
Segment Add Va 
Segment Update vit 
Segment Delete a We 
Cursor Key Select (Inguiry) i 
Cursor Key Select (for Update) ae Oe 
End Inquiry ‘p? 
File Operations Inquiry 'g' 
| Browse (ISAM and VSAM-XKSDS oniy) ‘G1! 
Seq.Not Record Found{not for SAM) 'G2! 
Inguiry for Update (not for SAM) 'G3! 
Record Add HH? 
Record Update (not for SAM) ‘TI! 
Record Delete (VSAM-KSDS only) "11! 
Search (DMS/CICS/VS INDEXED only) wal 
Set Sequential (ISAM, KSEIS only) ‘x? 
End Sequential (ISAM, KSDS only) ‘'K1' 
Cursor Key Select (Inquiry) ‘'L? 
Cursor Key Select {for Update) 'L3' 
Sel.Pen Key Select (Inquiry) ‘'M° 
(DMS/CICS/VS INDEXED only) 
Sel.Pen Key Select {for Update) ‘'m3* 
(DMS/CICS/YS INDEXEL only) 
Copy (not tor SAH) fi 
End Inquiry es 
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Data Routing Data Route a Oe 
Send Message "kK 

Get Message “RI 

Send Image Ss! 

Get I[maye seo be 

Program Control Call User Program yee ed 
Return to Calling Program oe Of 

Reset Communication Fields (all) 'V* 

Delete Communication Fieids ‘vii 

Reset Comm. Fields (Selectively) ‘v2! 

End Transaction at 

Systen Services Load PF Key Table op 
Load Edit Mask Table RA 

Set Time, Date, Operator ID 'Z? 

User Supervisor Function ‘>? 


NOTE: The File Rebuild Supervisor Function 'Y! of ODMS/VS-OS 
is not Supported under DMS/CICS/VS. 


(11) DMS/CICS/VS is divided into two components charged 
separately: a Base Product and an Aplication Generation 
Feature. 


ED CEES Ve ON aS Go ee 


- Base Product. Contains the online functions and the 
orfline maintenance facilities. That is, the online 
modules correspondig to the Display Manajement and 
Messaye Switching transactions, the Batch Utilities 
for creation/maintenance of files (mainly UMS/CICS/VS 
INDEXED files), and the macros to taylor the online 
DMS/CICS/VS environment. 


~ Application Generation Feature. Contains the offline 
modules to create tne user aplications from using the 
Specificatios coded on the DMS/CICS/VS forms. That is 
the batch modules that produces the different tables 
required by the operation of the Ease Product. 


This allows users with multiple locations to generate and 
test applications at a central site and run in an 
execution-only mode at other locations. That 18, the 
development site will use the Base Product and the 
Application Generation Feature, while the other locations 
need only the Base Product for execution. 
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(i111) Central Service including the IBM Support Center, 
Will be available until discontinued by IBM upon twelve 
month's written notice. Local Service, provided by IBM 
Customer Engineering, will be available at no charge till 
December 31, 1979. Then, Local Licensed Program Support is 
available (provided by IBM Customer Engineering) until 
discontinued by IBM upon twelve month's written notice. 


DMS/CICS/VS-OS (57480-XC5) Central and Local Services 
provided until discontinued by IBM upon six month's notice. 
Local Service will be provided by IBM Customer Engineering. 


This Program Service will dramatically impact the 
quality of the product and the Service to the users compared 
to the Class B Program Service of DMNS/VS. 


The name of the product has been changed from Display 
to Development Management System/CICS/VS to better reflect 
its broad capabilities and full Service Support. 
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DUSZCICS/VS-DOS RELEASE 2. 


(i) Calculations and edit capabilities to perform simple 
arithmetics (add, Subtract, multiply and divide); to 
validate fiels (move, compare/test, table lookup, 


de-editting and setting of attribute bytes); and to control 
operations (execute new function identifier, write-no-erase, 
terminate a transaction, etc.). 


A new form for Calculation/Edit card type 'K' is 
provided to allow the specifications of the new functions to 
take place at predetermined Cycle Points. These Cycle Points. 
are the Same pre/post exit points used for the execution of 
user written subroutines. The new functions provided will 
suffice for the majory of the situations where a user 
written subroutine is needed. Nevertheless, should a special 
processiny requirement appears, the Calculation/Edit 
functions allow for exit and return from/to the line 
sequence of function being executed at the corresponding 
Cycle Point. 


The Calculation Operations available are (This 
functions are explained in the DMS/CICS/VS General 
Information manual indicated in the literature) : 


Arithmetic Operations Add oa 
Subtract ined 
Multiply “> 
Divide $/' 
Move Operations Move Remainder MVR 
Move MOVER 
Move Left MOVEL 
Merge Terminal Data MERGE 
Testing/Compare Operatns. Compare COMP 
vest Display Field TEST 
Setting Field Attributes Set a Field Attribute SET 
Table Lookup Operation Search a Tabie FIND 
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Control Operations End Processing Cycle | EXIT 

| Execute New Function ID NEWFTI 
Terminate a Transaction TERM 

Terminate With a Dump TERMD 

Woite Error Message © WMSG 

Redisplay RDISP 

Write no Erase WNOER 

Conversion Operations De-edit DEDIT 
(11) DL/I enhancements to display repeated under repeated 
segments. One of the benefits of this ability is 


Simplification of the retrieval and updating of segments 
present in a Bill of Material database. 


The ability to Add and Update repeated dependent 
segments. | 


Renoval of the former restriction that precluded the 
interspérse of segments on a screen for Add and Update 
operations. Now the designer may decide whatever arrangement 
of segment fields on the screen. 


Variable length Segments will be supported. 


The Inquiry ‘windowing! operation can be stopped 
after a certain number of segments have been found or a 
certain number of ‘pages have been built by DMS/CICS/VS. The 
operator can dynamically Sserect the number to be used during 
the Inquiry. 


(111) Add and Update files and/or data bases across 
multiple panels. This provides the capability to capture 
data from a set (up to sixteen logically connected panels) 
of displays and to construct from this data a single logical 
file record or a single data base path for each one up four 
files or databases. The actual Add or Update occurs after 
the last panel of the set is processed. This 1S provided 
for DMS/CICS/VS-OS under Release 1.0. 
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(1) File and data base Support through cCICS/YS Inter 
System Communication (ISC) facility. The ISC support 
provides the capability for connecting CICS/YVS systems 
together. This allows an application running in one systen 
to access files and DL/I databases, and initiate the 
processing of applications or queue mesSsSayeS on connected 
CICS/VS systems.These facilities give installations the 
ability to distribute system resources such as application 
programs, files, and databaseS in a network without the need 
for resources to be attacned to the system that is 
requesting access to then. 


(11) RPG-TI command Level support of the Formatted Data 
Facility (FDF) as waS provided in former Releases for the 
uSers of COBOL, PL/I and assembler Jlanyuayes to help in the 
code of post-response and pre-display exits. The FDF allows 
for symbolic access to data irom the Terminal Input Output 
Area (TYIOA) at the indicated exit or cycle points. 


(111) DMNS/DED generation from input supplied by the DB/Y/DC 
Data Dictionary Program Product. The uSer will not be 
required to code DMS/CICS/VS Assembler macro instructions 
for DMS/DBD generation. This should simplify definitios of 
DL/I appiications. This optional facility ceguires the 
DB/UC Data Dictionary Program Product (DOS/VS: 5746-XXC, 
OS/VS: 5S780-XXF). 


(iv) Interactive Application Vefinition facility to allow 
for Data vefinition, Panel Detinition and Process befinition 
in an interactive, online environment. These facilities are 
incorporated in the Application Generation Feature of 
DMS/CICS/VS. They will allow for interactive (online under 
CICS/VS) specification of the appiication replacing the 
coding of forms and its batch process. The Application 
veneration Feature is composed of the [Interactive 
Application Definition Facility (online) and the Batch 
Application Generation (oifline). The first maintains the 
specifications in the a library called Application 
Specification Library. From there, the tables required by 
the Base Product are created py the Batch Application 
Generation. | a 
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Data Definition 


TER Rn veh WERE <e cant, came inde cep a ee ane eae qa 


Data Definition allows the uSer to describe the file 
organization, data structure, and field characteristics of 
files and databases like names, data attributes and layout. 


All characteristics of the data structures are stored in the 
Application Specification Library from where they can be 
displayed/updated online. 


The specifications are referenced during Panel Definition 
and Process Definition. 


Panel Definition 


th ren Nn ene an SUNY ERED CE NED CUEID ete ARERED CERT OAD we 


Panel Definition allows the user to describe the general 
Characteristics of the map and display device to be used. 
Then, the map furmat can be defined by keying the fixed and 
variable fields onto a model screen. This is done by keying 
the data in the sate poSitions desired for actual display. 
Editing facilities are provided to insert/delete lines and 
to shift data. 


Once the map is formatted, the user iS prompted to describe 
the field attributes in the order they appear on the map. 
Default ainformation is provided from the Data Definition 
stored in the Application Specification Library. fhe 
completed maps are stored in this library as well. 


Process Definition 


EEE acum ents oxime wine <8 eo A AED eaten nie AD i atten ale an aa 


Process Definition allows the user to describe the 
DMS/CICS/VS Eunctions to be performed for a particular map 
when is displayed. The user specifies the operator responses 
and associated Supervisor Functions, cCaculation/Editing to 
be performed and exits (if still necessary). 
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Addational information about the fields displayed at any 
Stage of Interactive Application Definition can be requested 
by the user. Return to the current Stage is automatic. 


During the Definition process, the user may refer to other 
Stages of the process and return to the current stage. 


The last Data, Panel or Process Definition is saved and 
automatically scetrieved when the corresponding task i158 
restarted ufter an interruption suffered either by the uSer 
or the systen. 


Completed new specifications can be saved as a test version 


until the user decides to replace the already existing 
version with the new one. 
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GH20-4298- 

GV20- 0658-0 
GH20-4516-0 
GH20- 1863-1 
SH20-1865-2 
SH20- 1864-0 
SH20- 2024-0 
LY20-220b6-0 


S7T46XC200 


GX20-2000-1 
GX20-1999-0 
GX20- 1998-0 


L7o-002 


EB77-071 


B77- 06 


B7 7-07 


B7 7-07 


B/8-01 


10.120 


DMS/VS Program Product Design Objectives 

DMS/VS Slide Set 

DMS/VS Program Product Specifications 

DMS/VS General Information Manual 

DMS/VS Program Reference Manual 

DMS/VS Operations Guide 

DMS/VS Application Program DeSign Guide 

DMS/VS Logic Manual 

DMS/VYS SECON entries. Some tips and early information 
is also available. When pulling out entries use date 
instead of ‘pin’ number since some entries are re-updated 
on the Same place. 

DMS/VS Panel Description Form 

DMS/VS File Description Form 

DMS/VS Data Transfer Specification Forn 

DMS/VS Highlights, published by Central Region Support 
Intermediate Systems of Canada on November 22, 1976. 
Distibuted by WTSC Boeblingen on publication B77-01, 
March 30, 1977 


DMS/VS Applications and Systems Programming Workshop, 
Handouts published by WTSC Boeblingen fFarch 30, 1977 
DAS/VS Questions and Answers, publischeda by the End User 
Product Center, Canada and distributed by WICS Boeblingen 
september 9, 1977 


DKAS/SVS & 3270 SDLC=YES, End USers Product Center, Canada. 
WESC Boeblingen distribution November 10, 1977 


DMS/DOS/VS and 3790 (3270 CM), End User Product Center, 
Canada. WTSC Boeblingen distribution November 10, 1977 


DMS/VS and DL/I-Entry Secondary Indexes, working example 
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uSing secondary access to a database. Published by WTCS 
Boeblingen March 15, 1978 


DMS/VS Application Design Guide, pre-release published by 
WISC Boeblingen March 15, 1978 


DMS/VS Papers, 14 papers from W. Brent Lingenfelter (DPD), 
published by WTSC Boeblingen April 17, 1978 


DMS/VS. Standard System Design, Theory and Practice, paper 
from W.Brent Linyenfelter (DPD), published by WTSC 
Boeblingen February 9,1979. 


DMS/VS DOS/SVS V1 M1 PTFOQ0O01 Tape, Performance Enhancements 
published by WTSC Boeblinygen February 9,1979. 


DMS/VS DOS/VS Vi M1 PTFOOU2 Tape, Larye Screen Support 
published by WTSC Boeblingen March 16,1979. 


DMS/VS Education Guide deveioped in the Dallas Education 
Center (DPD), published by WTISC Boeblingen March 16,1979. 
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GE19-5246 DMS/CICS/VS Foil Presentation. Developed to introduce 
DMS/CICS/VS to bP Managers and technicians 
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The following 
Level exit. The 
Assembler Sample in the 
(APPENDIX D and panel 
SH20- 1865-2. 


// UPSI 01 
// BXEC DFRERP1$,SIZE=128K 


example shows how 
example performs the Same 
DMS/VS 

DMSSP120, 


Chapter 10.7 
PROGRAMMING FACILITIES 


RPG-IT Command 
function as the 
Program Reference Manual 
figure 59), torm 


to code an 


TRANSLATOR OUTPUT INTO SYSO002 
COMMAND LANGUAGE TRANSLATOR FOR RPG-II 


0101 #H c 
O1001H*® eee 
01012H* CICS/VS EXEC COMMAND CALLS ONLY, NO DL/T 
01013H* --------------------------~~---------------+---+----+-------+-+--+- 
0201 IDFHDUS DS | | 

0202 I 1 4 SELPTR 

0203 I 5 8 TWAPTR 

0204 I g 12 USRPTR 

0205 I 13. 15 FWAPRT 

0O20512% eee 
020521*% BASE LOCATOR FOR LINKAGE. POLNTERS FOR THE DATA STRUCTURES (DS) 
020531®% -------------------------------~-------------------------------- 
0206 IDMXTWA DS 

0207 I 417 420 TUEPLA 

O20710® eee 
02072T* DMS Savon er oe WORK AREA DATA STRUCTURE. ONLY {WAUEPLA NEEDED 
020731* ----------------------~----------------+-----+------+-+--------+---- 
0208 IDMXUSP DS 

0209 I 1 8 CICSAA 

0210 I 9 16 USRPGH 

O211 TI 17 24 USRFNS 

0212 I 25 25 USRRC 

0213 1 26 26 USROPT 

0214 I 27° 27 USOPTM 

0215 I 28 28 USRMSG 

0216 I 29 29 USRFI 

0217 I 30 30 RESRV1 

04/04/79 IBM INTERNAL USE 10.123 


~hapter 1U.7 


DOS/VSE PLANNING GUIDE 


ROGRAMMING FACILITIES Volume If ZZ10-9826 
0218 I 31 31 USRDME 
0219 I 32 32 USREXT 
0220 Tf 33 36 UFTDID 
0221 1 33 34 USRDLE 
0222. 1 37 4O USRDAD 
0223 I 37 40 USRACD 
O224 T 41 72 USRRKY 
G225 I 37 38 USRPLE 
0226 I 39 4&O USRFLE 
0227 I 41 140 USRFLD 
0228 I 141 144 USPBLK 
CF: a eC, a a ee a ae ee oe a ee ea eee ee ee re a eae ee eee eee 
O22821I* COMPLETE DMS USER PARAMETER LIST DATA STRUCTURE 
O22831* ------------------- ~~ - nn nn ee ee ee 
0229 IDFHFWA LS 
6230 I B o5 o80SLTAX 
0231 1 B 69 T72U0SLABT 
0232 I B 1071 1040SLAMT1 
0233 I B 133 1300S5LAMT2 
0234 T B 165 1608USLAMT3 
235 LI B 197 2000SLAMT4 
0236 I B 229 2320SLAMTS 
1237 I B 261 2640SLAMT6 
0238 T B 233 2900SLAMTT 
O2381%* st 
023821* FILE WORK AREA DS. ONLY FLELDS OF INTEREST MUST BE SPECIFIED 
O23830% ~------------- -- nn ee 
0301 ¢ X ENTRY PLIST 
0302 ¢ PARM DFHELE 
0303 c PARM DFHCOM 1 
O304 Cc PARM DFHDUM 
0305 c PAR DEXTWA 
0306 Cc PARM DMXUSP 
0307 ¢ PARM DFHFWA 
03071C% Ape et sega dg ec ey tte Aten hes Acces ages tt eee ee ee et 
03072C* PARAMETER LIST LTO ALLOW daisienin DHXUSP AND DCFHFWA ADDRESSABILITY 
Q3O07 380% ener mn en nn a a re eee 
0308 c ADDRESS EX#< 13 
0309 Cc TWA ELEM TWAPTR 
0310 Cc MOVE TUEPLA USRPTR 
O311 ¢ CALL *ILNSAD! 13 
0312 ¢ MOVE USRDAD FWAPTR 
0313 ¢ CALL "ILNSAD! 13 
ES SS Cr, ae ee ae eee ee ee ee an ea eee 
03132c* STEPS TO MAKE DMXTWA, DMXUSP ANCL DFHFWA ADDRESSABLE 
03133C* -------~------------- ~~ - ee 
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0314 Cc SLAMT1 ADD SLAMT2 WORKAR 90 

0315 C SLAMT3 ADL WORKAR WORKAR 

0316 Cc SLAMTY ADD WORKAR WORKAR 

0317 Cc SLAMTS ADD WORKAR WORKAR 

0318 C SLAMTS ADD WORKAR WORRAR 

0319 Cc SLAMT7 ADD WORKAR WORKAR 

0320 C 0.05 MULT WORKAR SLTAX 

0321 ¢ SLIAX ADD WORKAR SLAMT 

SQV CH aa ccna Dern ccc ea at ts as natch eg gs acon 
03212C* ARITMETIC OPRERATION TO ADD SALE AMMOUNTS ADDING 5 ® TAXES 
03213C# ---------------~--------~-~~-~---------~-----+---+-------------+--- 
0322 Cc BITOF* 11111111" USRRC 

0323 C RETURN EXEC 13 

03231Ce eee 
03232c* USER RETURN CCDE IS SET TO X'00* AND RETURN TO DMS 
03233C# ------------------------------~+--+--~---+---+++----~+-~--+-+-++-+++-+-+ 
/* 

// BEST 01 COMPILER INPUT FROM SYS002 


// OPTION CATAL 
PHASE DMSSPUX1,# 
INCLUDE DFHERI 
// EXEC RPGII,SIZE=80K 
// EXEC LNKEDT 


REPLACES SAMPLE EXIT PRM PANEL120 AND APPENDIX D 
INCLUDE EXEC INTERFACE STUB FOR RPG-II 
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Status 

Latest Release 
Announced 

Planned Availability 
Manuals Available 


SIPO's Available 


Selected Product Line 
Installation License 
Pre-Installation Test 


Program Services 
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Program Product 
2.0 
1/79 
4/79 
G/719 


DOS/SYSE SIPO/E (Plan.Avail.3Q79) 
VM/SDOS/SVS SIPO/E (Plan.Avail.4Q79) 


yes 
N/A 
30 days 


Central Service until discontinued 
upon 12 months written notice. 


Local Service at no 
12/31/79 then 
Program Support. 


charge until 
Local Licensed 
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10.8.1 PRODUCT FUNCTION 


SORT/MERGE Release 2 will run under DOS/VS Release 33 and 
34, or under DOS/VSE on a /370 machine and under DOS/VSE on 
4300 processors, either in ECPS:VSE mode or {370 
Compatibility mode, 


The program can detect which release is controlling it and 
whether or not the system 1S in ECPS:VSE mode. 


Release 2 provides an SVA load list ($SVASORT) containing 
the Release 2 phaseS which are eligible for the SVA, 
together with conditions for loading them. The SVA load list 
is included as a load module in the distribution file. The 
current SVA procedure will still be enhanced and maintained 
for users of Releases 33 and 34, but will contain only those 
phases which may execute under control of these releases. 


ECPS:VSE SUPPORT 


- (ib a aap ae a» 7 CS ett RED ED TED EE 


Release 2 uses IORBs for its I/O requests. Page fixing takes 
place if a page fixable area of sufficient size for the 
SORT/MERGE 1/0 areas was defined with the SIZE command. This 
is not done, however, if the SORT/MERGE 'VIRT' option is 
specified. 


2370 SUPPORT 


Release 2 continues to use IDAL CCW addressing, but uses new 
system interface facilities (EXTRACT, GETVCE, etc.), in 
parallel with the old interfaces, in order to permit 
execution under DOS/VS Releases 33 and 34. 
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SORT/MERGE V2R2 (from here on referred to as SM2) can use 
FBM devices when cunning in ECPS:VSE mode on 4300 
processors. It uses EXCPS when writing to or reading from 
input, output, and work files on FBM or CKD devices. 


INPUT FILES 


TORS WERT. AS RGD EERE ate Cinta ete ~cate mee 


FBM devices can be used aS input to both SORT and MERGE. 

SAM files on FBM devices may be mixed with SAM files on 
non-FBM devices, but not with VSAM files. VSAM files on FBM 
may be mixed with other VSAM files. The following functions 
are restricted for SAM files on FBM devices: 

® ASCII - not allowed 

* ADDROUT - not allowed 


* BYPASS - applies only to wrong-length, variable-length 
records. 


* KEYLEN - not allowed 
e Split Cylinder Piles - not allowed 
Because of the increased size of the input module, 


MERGE-only applications will need more virtual storage (or 
SVA space) in all cases (whether FBM or not). 


OUTPUT FILES 


En ee een ee Gem ae CRANES CANNED ARNE TERE seggeD 


FBM devices can be used for output from both SORT and MERGE. 
SAM and VSAM files are supported. 


The VERIFY option may also be used for FBM devices. 
The control interval size should be Specified in the SORTOUT 


DLBL statement. If it is not specified, the CISIZE will be 
set to a value large enough to contain the blocksize. 


10.128 IBM INTERNAL USE 04/04/79 


DOS/SVSE PLANNING GUIDE Chapter 10.8 
2210-9826 Volume IT PROGRAMMING FACILITIES 


CHECKPOINT FILES 


SREP AND AD ~ER CD INS NONE CANE GD ae OR LI OR Ri. RI 


SORT checkpoints can be written to FBM files. Only one 
extent can be defined. If SORT is called by another progran, 
or if usSer-written routines are used, this extent must be 
large emough to checkpoint the whole partition; otherwise, 
it must be large enough to checkpoint only the SORT storage, 
as defined by SIZE, STORAGE, or default calculations. 


WORK FILES 


SORT allows the work files to be allocated to FBM devices. 
It 1s also possible to mix one FBM device type with one CKD 
device type. 


WORK=DA may be used with FBM work files. 


The ERASE option may be specified. The erase function writes 
zeroes into all extents occupied by work files. 


FBM support for SYSIN, SYSLST, and the debug files is 
obtained by recompiling all SORT/MERGE modules which contain 
DTFOP, CPMOD, or DYFSL. 


The maximum input and output block size is 32,761 bytes when 
FBM devices are used. If the input or output file is 
declared as fixed unblocked, the block size value represents 
the maximum record length. The limitiny factors are the 
amount of virtual storage allocated and the type of work 
device. If CKD work devices are used, the maximum record 
length 1S limited by the track capacity. If FEH devices are 
used, the maximum record length of 32,761 bytes may be used. 
Note that block descriptor words and control field 
specifications have the same effect on the maximum reord 
length as in Reiease 1. 
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Variable-length spanned records can be used for input to 
SORT or MERGE or may be requested as output. A new parameter 
'SPAN' is added to the INPFIL and OUTFIL statements for this 
purpose. It is valid only for records described as TYP#=V 
in the RECORD statement; it 1S not valid for VSAM files, as 
spanned VSAM records are already Supported. ADDROUT cannot 
be combined with variable-length spanned input. If BYPASS is 
requested and a block is found to be in error, all records 
which are completely or partially contained in that block 
Will be skipped. 


The limiting factor for the maximum record length is the 
track capacity of the work device, if it is a CKD device. If 
it iS an FBM device, the record length may be up to 32,749 
bytes, but may Sometimes be less, depending on the SORT 
control field specifications. 


SM2 can handle "null segments", i.e. Segments containing 
only a segment descriptor. 
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10.8.4 USABILITY IMPROVEMENTS 


SORTS we ere CnrE CUD GEED COMED GENES ED SRS GD ap Ce Ri NEE ARTES AI ERR “Re TNE Onin adecape setiem, EMCI wate 


PRINT FILE ROUTING OPTION 


For SORT operations called or attached by another progran, 
the ROUTE parameter in the OPTION statement may be specified 
as ROUTE=xxx, indicating that the output messages and debug 
information (COMMA and trace table) are to be printed on 
SY¥Sxxx instead of SYSLST or SYSLOG. However, the partition 
dump wili still appear on SYSLST and critical messages will 
Still appear on SYSLOG. xxx may be any number between 000 
and 221 that is valid for the partition; leading zeros may 
be omitted. This option is not supported if the program is 
invoked by Job Control (EXEC SORT). | 


OVERLAPPING CONTROL FIELDS 


All types of SORT or MERGE control fields may overlap 
freely. 


OUTREC fields may have any position and length. For 
variable-length records, all fields must lie within the 
minimum record length (L&). 


The texts of a number of messSaygeS have been Changed and Some 
DIAG messayes have been changed to information messages. See 
the Programmer's Guide for Release 2 of SM2 for full 
details. 


IMPROVED SYNTAX AND ERROR HANDLING 


RD “EE -RE ERED CUSERS ence TEC Bee me ae cage ee ae eee RSD CEES EES OO I So REA TTY Kael “UTES EE IN: CT ACI 


If a syntax error is detected by SM2, the remainder of the 
Statement is flushed. Any continuations of the statement are 
printed and flagged with "FLUSHED' in columns 74-80. 
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SM2 will execute diagnosis and terminate if extent 
specifications are incorrect. | 


Incorrect specifications are: 
° Overlap of output files with the work file(s). 


* Overlap of one work file with another in the same SORT 
application. : 


Checking 1S done after the OPEN for a file or additional 
extent. 


If SM2 as dynamacally invoked by another program, the 
control statement list will be printed if the SORT/MERGE 
PRINT=ALL option is in effect. The statements will be 
printed atter syntax checking and after any error messages. 
The alternative, collating sequence table (for the AQTT 
Statement) will not be printed. 


Printing of each statement starts on a new line. If a 
Statement will not fit on a single line, it is continued on 
the following Jline(s). A maximum of 72 characters of 
statement text is printed on each line. 


THE ANALYZe STATEMENT 


This new statement, with the format - 
(label) ANALYZE CALC 


is available for both invoked and standalone SORTS and can be used 
to retrieve information on how SM2 will use the 

environmental 

Specifications and to debug new SORT/MERGE applications. 


This function provides the following information: 


Storage allocation, 

SM2 capacity, 

Storage requirements, if too small, 
BuEfer allocation, etc. 


¢ 6 & 
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When SK2 recognizes’ the CALC option, the following 
additional options will be forced, regacdiess of how the 
user had specified them: DIAG, ROUTE=LST, PRINT=ALL, and (on 
termination) NODUMP. Furthermore, SM2 will assume a correct 
job set-up with correct file assignments. When it has 
completed Phase 0, and if it found no Severe errors during 
syntax checking, SM2 will terminate with the message 7C19I 
ANALYZE END. ThiS iS a critical message and will cause the 
jobstream to be flushed or the invoking program to receive a 
return code of 16. 
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SORT/MERGE permits the user to define default specifications 
for the following SORT/MERGE parameters: EQUALS, PRINT, 
ROUTE, STORAGE, SORTOUT, SORTIN, SORTWK, VERIFY, ERASE, 
DIAG, and DUMP. All of theSe (except EQUALS, which appears 
in the SORT statement) appear in the SORT/MERGE OPTION 
Statement. 


By changing the defaults to match his Specific needs, the 
user can avoid the necessity of specifying the parameters 
each time he uses SORT/MERGE; specification is required only 
to override the defaults. The user defaults may be defined 
after installtion of the program and may be changed at any 
time. All keyword parameters which have a variable number of 
values should be defined with the maximum number of such 
values which will be needed. SORT/MERGE will then, each time 
it is executed, ignore the superfluous default values. If, 
for example, the user wishes to use up to five work files, 
the default should be something like 
SORTWK=(15,16,17,18,19). If only two work files are used at 
execution time (WORK=2), SORT/MERGE will check and use only 
the work files on SyYS015 and SYS016, and will ignore the 
others. 


The generation and installation options are distributed as a 
Separate assembler macro on the distribution file. This 
macro assembles into a jobstream which replaces a dummy 
module with a module containing the default specifications. 


If a specification contradicts other options at execution 
time, VERIFY will always be used if the output iS on tape 
and EQUALS will be forced if SUM 1S specified. In addition, 
an information message will be issued. 


The following new SM2 statement parameters are provided to 
permit the default specification to be overridden: NOEQUALS, 
NOVERIFY, NOERASE, NODIAG, and STORAGE=(,NOVIRT). 


The program will automatically try to uSe command chaining 
when reading input from, or writing output to, tape or CKD 
files (SORT only). Command chaining On input can be 
suppressed by specifying NOCHAIN in the INPFIL statement. 


The BYPASS option will prevent command chaining on input; 


the VERIFY option suppresses it on output. SM2 does not use 
command chaining across track boundaries. The effect of 
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command chaining 18 to reduce the number of EXCPS, thus 
reduciny CPU time and elapsed time. 


As already mentioned, SM2 will operate with DOS/VS on both 
4300 processors and /370 machines. 


AMEE? Gan thet SRO AER IEG Rn Maas ate ace EE RR CE AIRED ENED URGES ope 


The following devices can be used for input, output, and 
checkpoint operations, as far aS they are supported by 
DOS/VS or DOS/SVSE : 2311, 2314, 3310, 3330 Models 1, 2, and 
11, 3340/44, 3350, 3370, 2400, 3400, 8809. 


Work files can be on: 2314, 3310, 3330 Models 1, 2, and 11, 
3340/44, 3350, and 3370. 


Notes: 
* 8809 streaming mode is not supported 
e Tapes may not be used as work file devices 


10.8.8 SOFTWARE CONFIGURATION 
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SM2 has the same Supervisor requirements aS Release 1 when 
executed under DOS/VS Release 33 and 34, or under DOS/VSE in 
/370 Compatibility mode (FOPT macro parameter ‘'RELLDR’ is 
Standard for the DOS/VSE supervisor). If DOS/SYSE is used in 
ECPS:VSE mode, FOP£ RPS=YES is the only required parameter 
(for non-FBM DASD) if RPS support is desired; all other 
supervisor options are standard or have been made obsolete. 
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SM2 may need more virtual storage for execution of a given 
application since the input and output buffer allocations 
now depend on the Specified Control Interval size. 


The a input and output code for MERGE-only jobs has also 
increased in size and additional virtual storage may be 
required, if SORT/MERGE is not loaded in the SVA, when 
executing applications which do not use FBM devices. 

The minimum allocation per work extent has been Set to 64 
blocks in order to allow for a meaningful SORT work file 
block size. | 


The maximum block size for a work file on an FEM device is 
32K bytes. | 


4300 PROCESSOR SUPPORT 


If neither STORAGE nor SIZE is specified in ECPS:VSE node, 
SM2 will use all available storage for execution. | 


SVA REQUIREMENTS 


For all code, SM2 requires approximately 275K bytes of 
storage in the SVA. 
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SORT performance 1S expected to be better in environments 
where SM2 can choose command chaining, i.e. when sufficient 
Storage 1S available. The elapsed time improvements will be 
large, while the CPU time improvements will be moderate. No 
iaprovement will occur in environments Where the input and 
output block sizes are already optimal. 


10.8.11 COMPATIBILITY 


om Ee ad ' <n. comm ED eh CED ah GED am ap me en Cm ee ye 


Release 2 of SM2 1S compatible with Release 1 and runs under 
DOS/VS Releases 33 and 34, as well as under DOS/VSE. 


Certain functions (ADDROUT and KEYLEN if the input file is 
on an FBM device) are not available in DOS/VSE. Any attempt 
to use these functions will be diagnosed by SM2. 

VSE/VSAM is required for VSAM file processing under DOS/VSE. 
Note: All functions described in the first edition of this 


Guide (DOS/VS R34 Planning Guide 22Z10-9822-00), but not 
mentioned here, are still available. 
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10.8.12 SUBMARY OF SORT/MERGE DEPENDENCIES 


Fi a a as a a el al ad te ea 
} Dependency Iten | Remarks i 
}---~-~------------4}-------------------------------------------4 
|} PROGRAM SUPPORT | Programs that can dynamically invoke l 
| SORT/MERGE: 
| @- ASSEMBLER i | 
| <- COBOCL/VS | | 
| - PL/I | | 
|} - DOS RPG ITI | via Auto Report Feature | 
} - DOS/SVS RPG II | via inherent Auto Report Feature | 
wee ee ee ee ee —--—— | 
}] UR SUPPORT | Any unit record device supported by DOS/VS | 
}+}-—-—-—-~—-——_-—------—-—--+--—-—4----—-+---—--- +--+ + + ———~+——+————{ 
| TAPE SUPPORT | Any tape Supported by DOS,/VS (NOT for work | 
| files 
nn ee fe sai i ae ht i a a ca a em a a a a a 2 —{ 
| DASD SUPPORT i | 
1 = 231 | anput/output files only | 
{ ~- 2314 | | | 
! ~- 2319 | | 
} - 3310 | FBM | 
{ = 3330-1;,2,171 { | 
= 333395 hy. 5 | | 
1 - 3340 | I 
1 - 3344 | | 
} - 3350 | | 
| - 3370 | FBM | 
Se ee ee ee eee 
| DATA MANAGEMENT SUPPORT ] 
i - SAM | } I/O files (incl. Spanned) and work files | 
| - DAM {| Work files only i 
{1 - VSAM ] 1/O files only (KSDS, ESDS, RRDBS) | 
Se ee ee eee 
| CURRENT RELEASES | j 
| - 2.0 | | 
Weise ea ee el ea eee eee eee oe Y NSAI DSO AMM AA a I Se ee PSR NE IY SE RE YN ON DERE BIN ed eT NR NRT OE ROTOR | 
Notes: 
(1) Work files may be mixed on any TWO supported DASD device 


types (including FBM). 

(2) Input files for a SORT or MERGE job may reside on mixed 
tape and DASD types. 

(3) Input records may be fixed or variable length, blocked 
or unblocked SAM or VSAM files (but not mixed) or may be 
a mixture of FBM and CKD YSAM files. 

(4) No special effort has been made to support 8809 
streaming mode. 
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GC33-4043- 
GC33-4042- 
GC33-4047- 
SC33-4045- 
SC33-4OQ44- 
GX33-8002- 


LY¥33-8044- 
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General Information Manual (GIM) 
Licensed Program Design Objectives (LPDO) 
Licensed Program Specifications (LPS) 
Installation Reference Manual (IRM) 
Programmer's Guide (PG) 


Reference Card 


Program Logic (PL) 


IBM INTERNAL USE 10.139 


CHAPTER 11 


VSE/INTERACTIVE COMPUTING AND CONTROL FACILITY 


RELEASE 1 


(5746-751) 


O4/05/7T9 IBM INTERNAL USE 


4410-9826 


DOS/VSE PLANNING GUIDE 


Volume TI 


ONTENTS 


CHAPTER. “14 VSE/ICCEs. « = % @ & %.% 


11.1 INTRODUCTION. . 2 2 2 «© 2 « « 


diet Bae 


11.3 PRODUCT FUNCTION 


11.3.1 General Description ... . 
11.3.2 Equipment Supported .... 


11.3.3 Highliyhts of New 


TeLMinal Support «. » « « «© « « « 
DASD.SQPPGLY <. “2: - 6: a ace ee we 
Tape Support .. ° a a oe 
Functions 


11.3.4 Detailed Description of New 
Conversion from FDP to PP and Adaptation to DOS/VSE. 
bynamic Label Information Handling . 


Dynamic Disk Space Allocation. . 


Monitor Call Class 4. ..6. . 


eo 


AND ENHANCEMENTS 


a 


Functions 


ad 


2 


Supervisor Generation Option for VSE/ICCF. 


= 


» 


e 


2 


Intercept of Chanyed Supervisor Services . 
Operator Communication with VSE/ICCF . 
Device Type Specification for Library File 


Cancel of Interactive Partitions 
Fixed Block Mode (FBM) Support . 
SUDPOEt Of TRE «w= 6: & <4 6: 4% 
Support of New bisplay Terminals 
VSE/SVSAB/AMS Support . .« 2. « « e« 
Interactive Usability Aids ... 
ENELCOCUCTIOR: &. a. Soe) ee we: Se OS 
Implementation . . « « = 2 » « » 
PIiSULLDUTION ~. ~c <s Sy vet eh cas a wes 


1te3e5 Tnteriacess: »« ~« «4 «<< =» « * 
11.3.6 Security. . «. « an ae ee ae 


11.3.7 Summary of FDP- PP 


Changes . 
VSE/ICCF Generation Options. .. 
External Initialization Changes. 
Utility and Control 
Display of VSE/POWER 


11.3.8 Performance . . .« « « « « e 
11.3.9 Dependencies. 2. . .« « «© « « 


Products (Equipment) .. . . « » 
Programs 2 2 s s * e * * 2 2 2 


11.4 INSTALLATION PLANNING 2 
11.4.1 Shipment Package Layout a 
11.4.2 VSE/ICCF Generation ... . 


O& /05/79 


IBM INTERNAL 


lay ® 


2 


® 


2 


2 


a 


USE 


Statement Changes. 
Reader and Punch Queue.:. 


® 


2» 


2 


2 


2 


= 


*» 


® 


a 


bad 


Chapter 11.1 
VSE/ICCF 


Chapter 11.1 
VSE/ICCF 


DOS/VSE PLANNING GUIDE 
Volume II 


11.4.3 Pregenerated Version of VSE/ICCF. * 
11.4.4 Disk Space RequirementS . . . .« « « 


User Profile and Library File Considerations 


Interactive Partition Workfiles. .. 
11.4.5 Terminal Control. . 2... 2. « « 
Terminal Control Considerations. .. 
CECOSLOOS NOs. de. & oe Bee oO we 
TTES & <2). w ‘ ee eee ee ee 
Control Unit/Terminal | SUPPOLts « ww « « « 


6 © @¢ @ 6 
*» 6 6 6 6 


11.5 Migration/Coexistence ... . °° 

11.5.1 Migration Path From SPM to VSE/ICCF 
THe LEDEALyY Pid « 3. Si aw we wa Se oe 
Educate the USer . .« « 2« « © «© «© © © © «@ 
Discover New FeatureS., . . « «© «© « s e « 
Features Different or not Available. .. 
Technical Considerations ... « = 

11.5.2 Migration Path from ETSS/II FDP — 


11.6 REFERENCE MATERIAL. « 2. «© 2 «© »© #@ @ « 


11 IBM INTERNAL USE 


= 
Es 


6 ¢© 6 @ 


s © ¢ @ 6 © &@© @ 8 


6 «© @ #6 &© 6 6 


6 € 6 6 &€ @ 


ZZ10-9826 


11.51 
11.52 
11.52 
11.54 
11.55 
11.55 
11.55 
11.55 
11.56 


11.59 
11.59 
11.59 
11.62 
11.62 
11.62 
11.63 
11.63 


11.64 


08/05/79 


DOS/VSE PLANNING GUIDE Chapter 11.1 
ZZ10-9826 Volume II VSE/ICCF 


INTRODUCTION 


This chapter contains a summary of details for the new 
timesharing program product VSE/ICCF. It is not the 
intention of the yuide to document every function, but where 
necessary details will be provided. fhe following topics 
will be discussed: 

(I) PRODUCT FUNCTION 

(Ii) MIGRATION AND INSTALLATION CONSIDERATIONS 

(IIIT) PRODUCT REFERENCE MATERTAL 
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11.2 VSEZICCF (5746-731) 
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Status 

Product Latest Release 
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11.3.1 GENERAL DESCRIPTION 
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VSE/ICCF is a follow on product of the FDP ETSS/II (5798 - 
CLR). ETSS has been documented previously in the PLANNING 
GUIDE in the WSC Special Distribution BO-SL01-78. As this 
document gave a description of the ETSS FUP it will be 
assumed the reader 18S familiar with the FDP. The ETSS S.E. 
GUIDE distributed via DAPS Form Number 2210-9824 also 
contains descriptions of the FDP, as of course do the FDP 
mManuaiS. The main aim of this section 18 to document the 
new program product features. 


The VSE/INTERACTIVE COMPULING AND CONTROL FACILITY Progran 
Product Release 1.0 (VSE/ICCF 21.0) 18S an adaptation of the 
widely used DOS/VS Entry Time Sharing System (FDP 5798-CLR) 
to DOS/YSE . VSE/ICCF uses either CICS/DOS/VS or TTF as 
its terminal control facility, thus ailowing uSers to 
establish a single, unified terminal environment supporting 
both timesharing and transaction oriented applications 
(CICS/LOS/VS only). 


The VSE/ICCF is an interactive system designed tu extend the 
power of the computer to multiple terminal users 
concurrently. The functional capabilities brought to the 
terminal users can provide Significant productivity benefits 
in many different user environments. The timeshared 
computer concept, while having nearly linitless 
applications, has proven to be of particular benefit in the 
areas of individual problem solving, programming development 
and maintenance, and education. 


For the general problem solving environment, the system 
provides the framework for complex problem solving utilizing 
the user's various high level language application programs. 
The professional programmer may uSe VSE/ICCF not only for 
program development, but for library Maintenance and 
creation of more complex job streams. High level lanyuage 
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programs aS well as Assembler may be compiled and tested 
directly from the terminal with the results received back at 
the terminal. A Submit-to-batch capability via VSE/POWER is 
also provided for the execution in a time-shared 
environment. One can write, edit, compile and execute 
programs without leaving the terminal. Interactive usability 
aids will be provided assisting the user to easily create 
various DOS/VSE jobs without having to deal with enon job 
control or job entry control cards. 


The system may be viewed aS a collection of tools: an 
online progran development system, an online library 
Maintenance system, a set of interactive uSability aids, a 
powerful context editor, a text manipulation facility, a job 
entry system, a time-Sharting/job-execution monitor and a 
facility for development and execution of interactive 
problem programs and DOS/VYSE Access Control-Logging and 
Reporting. 


The ETSS/II (FDP 5798-CLR) 1s the base for the progran 
product VSE/ICCF. It iS intended that VSE/VICCF 18S based on 
the DOS/VSE System Control Program (SCP) and VSE/ADVANCED 
FUNCTIONS package. No Support of TreleasSeS prior to DOS/VSE 
is provided. | 
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Both 4300 processors and /370-machines are supported in 
VSE/ICCF. Fixed Block Mode (FEM) DASD device is supported 
aS an VSE/ICCF library, aS SYSRES, and for user files 
accessed by programs from the interactive partitions. 


TERMINAL SUPPORT 
The terminal access method, BIAM-ES for TIF and BTAM-ES or 
ACF/VTAM for CICS/BOS/VS determines the terminal support 
available to the VSE/ICCF user. See the appropriate Section 
in this chapter for support of display stations and 
printers. 
Note: The prompters are written for display 
terminals. They will not be tested on typewriter 
terminais. 


DASD SUPPORT 


At least two Spindles should be present on the system. RPS 
is an VSE/ICCF generation option. fhe DASD Support is 
provided for the VSE/ICCF library, dynamic space area, and 
SYSRES on 2314, 2319, 3330 Model 1 and Model 2, 3330 Model 
11, 3340, 3350, and FBM devices, 


TAPE SUPPORT 
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For an installation with non-removeable DASD, a tape drive 
can be used for the installation of the system, but it is 
not required for operation of VSE/ICCF. | 
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11.3.3 HIGHLIGHTS OF NEW FUNCTIONS 
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Conversion from FDP to PP and Adaptation to DOS/VSE 
The VSE/ICCF Program Product is adapted to DOS/VSE (/370 and 
E-mode) in the following areas: 
The new label area concept of BDOS/YSE is used for 
dynamic label information handling; dumny labels are 
no longer required. 
Files which are permanently allocated from the dynamic 
disk Space area may be date protected aS normal 


DOS/VSE files. 


A new supervisor generation option for VSE/ICCF 
Support is introduced. 


Various generation options have been removed in 
VSE/ICCF These functions are now standard. . 


Monitor Call class 4 1s reserved for VSE/ICCF in order 
to allow VSE/ICCF tv intercept services which do not 
result in SVC's(e.g. LABEL macro, JOECOM macro). 


Intercept of new and changed Supervisor Services 
(COMRG, EXTRACT). 


VSE/ICCF operator commands are routed to the VSE/ICCF 
operator communication routine via the attention task 
directly and not via the CC STXIT. 
The device type specfication via UPSI-bits has been 
deleted. 
Support of (TF (Terminal Transaction Facility) and continued 
Support of CICS/DOS/VS terminal control 
Support of the New Display Terminals 3278 


VSE/VSAN/AMNS Support 


Interactive Usability Aids (prompters) 
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Aside from changes necessary to convert the FDP to a Program 
product and to adapt to the new 4300 processors architecture 
and to the fixed block mode, DOS/VSE provides a series of 
new centralized Services. These services, such as the 
common VTOC handler ana the Symbolic Lakel Access(SLA) 
facility, enables VSE/ICCF to be less dependent upon bDOS/VSE 
changes and to improve certain VSE/ICCF functions and the 
Maintenance of VSE/ICCP. The VSE/ICCF Program Product 
adaptation to DOS/VSE only includes those changes necessary 
to run on the new release, but also the uSayge of the new 
centralized services wherever possible. 


The following sections describe how VSE/ICCF appears to the 
uSer. 


DYNAMIC LABEL INFORRATION HANDLING 
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The dynamic label anformation handling of ETSS/II 
(/PILE.~job entry statement) must be adapted to the new 
label area concept of bBOS/VSE. In order to support 
VSE/ICCF, the label area wiil be extended by a new Subarea, 
called free-usage label Subarea {to be used by IBM 
components only). In addition, a search of the interactive 
partition labei area will pe made by SLA for all label 
reguests from interactive partitions. The search seyuence 
for retrieviny a label is changed to: 


1. Interactive partition's label sSubarea 
2- Partition's temporary label subarea 
3. Partition's permanent label Subarea 
4. System label subarea 


The dynamic file space label reyguests will no longer be 
handled by an VSE/ICCF transient, but will be read directly 
from their storage area in the interactive partition by the 
SLA routines through an interface to VSE/ICCF. This Search 
Will occur after the VSE/ICCF partition temporary label area 
is searched. 
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By taking uSe of the new label atea concept, the dummy file 
labels DTSDUMY, DISDUM1, DTSDUM2,...¥hich were reguired at 
ETSS/II ianitialization time are now unnecessary. 


In order to Support the definition of data sets on FBM 
devices, the /FILE job entry statement must be adjusted. 
The LOC=strttrk,ntrks parameter has the following meaning 
for a data set on an FBM device: 


strttrk For FBM the parameter Specifies the address 
of the physical block with which the extent 
Starts. 


ntrks For FPBM the parameter specifies the number 
of logical tracks the extent consist of. 
A logical track iS a unit of FEM 
Space currently implemented as 16 blocks, 


Moreover, a New parameter Called CISI4E=cinv, which 
corresponds to the new CISIZE-parameter in the bDOS/VSE 
DLBL - job control statement, 1S aaded to the /FILE job 
entry statement. With CISIZE= the user specifies the 
control interval size for the SAM files on a FBM device. 
The control interval Size must be a multiple of the 
physical blocksize of the FEM device. CISIZE= is optional 
and may only be specified in conjunction with TYPE=SEQ. 


DYNAMIC DISK SPACE ALLOCATION 


General 


AS with ETSS/II, disk space can be dynamically aliocated for 
jobs in interactive partitions from a dynamic disk space 
area which may consist of one or more extents on one or more 
disks of any Supported type (i.e. also a combination of FBM 
and CKD devices). CKD and FRM devices are supported. The 
number of extents the dynamic Space area may consist of 
equals the number of labels specifications given at VSE/ICCF 
initialisation time. 


Unlike in ETSS/II where the dynasic disk space area had to 


be defined via two direct access data SetS per extent, the 
dynamic space area iS now one or two multi-extent direct 


O“/SO5/7T9 IBM INTERNAL USE 11.9 


Chapter 11.3. DOS/VSE PLANNING GUIDE 
VSE/ICCF Volume II 2210-9826 


access data sets with the filenames DTISDYNC or DTSDYNW. The 
date protection fields of the labels are ignored. The 
absence of both labels indicates that VSE/ICCF dynamic file 
Space is not to be initialized. The normal DOS/VSE 
conventions are valid for defining the file via // BLBL and 
// EXTENT job control statements. 

Here an example for FBS 

// DOLBL DISDYNC,,0,DA 

// EXTENT SYSxxx,nnnnnn,1,0,block-address,number-of-blocks 
// DLBL DISDYNW, »0, DA 

// EXTENT SYSxxx,nnnnnn,1,0, panes ddress,number-of-blocks 
DTSDYNC denotes that the extents following acre to be cold 
Started uniess the operator specifically requests warn 
Start. DISDYNK denotes a Similar concept for warm extents. 


In an interactive partition the user can use the dynamic 
disk Space allocation as tollows: SAM and DAM are supported 
for CKD devices and only FBM-SAM for FBM devices. 


Organization of DISDYNC and DISDYNW 


Each extent of the file consists of a control record and 
uSer space. For CKD devices the first track of each extent 
is reserved for holding the control record. In the case of 
FBM devices the control record is located inthe first 
physical blocks of each extent. Dependent on the size of the 
extent, 1 to 16 physical plocks may be used for the control 
record. The control record contains information about the 
Status of allocation of the uSer space, The uSer Space may 
be allocated to user files in multiples of one track in case 
of CKD devices or in multiples of 16 pnySical blocks in case 
of FBM devices. The maximum Size of each extent of the 

dynamic disk Space area is 7200 tracks for CKD devices or 
7200*16 physical blocks for FBM devices. 


Aside from some general control information a control record 
contains one byte for each unit of allocation, that iS, one 
byte per track for CKD devices or one pyte per 16 physical 
blocks for FBM devices. There are as many allocation bytes 
in a control record of an extent as units of allocation 
exist in the extent. 
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Example where two physical blocks 
are needed for the control record 


Figure 2: Example of Dynamic Disk Space Allocation 


An allocation byte descripes the interactive partition which 
owns the allocated space and the disposition as specified 
Via the /FILE job entry statement Each control record will 
be date protected via a format 1 label in the vtec. The 
file-ids of the control record are uSer specified. If 
cold start of the dynamic disk Space area is requested the 
initialisation routine of VSE/ICCF creates the format 1 
labels for the control records and writes them to the VTOC. 
After that it builds the control records and writes them to 
the beginning of the corresponding extents. If warm start 
of the dynamic disk space area is requested the 
initialization routine of VSE/ICCF reads the format 1 labels 
for the control records from the VTOC and checks the extent 
information in the control records against the extents 
Specified in tthe label area. If an extent doesn't match 
With the information in the control record a cold start of 
that volume is performed. The operator has to specify the 
option at VSE/ICCF initialisation time that all extents 
(DTFDYNC and DTFDYINW) are to be cold or warm started. 


USage of the Dynamic Disk Space Area 


AS with ETSS/II tie user specifies a request for space to be 
allocated from the dynamic disk space area via the /FILE job 
entry statement. However, the parameter TRACKS=n for 
Specifying the size of the Space is replaced by the new 
parameter SPACE=n. If the dynamic disk Space area iS on CKD 
devices n specifies the number of tracks, whereas, in case 
ait is located on FBM devices on specifies the number of 
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groups of 16 blocks desired.This group of 16 blocks is much 
like reguestiny tracks and allows the same /FILE statement 
to hold for CKD or FBM without change. : 


Unlike in ETSS/II, the uSer nay specify expiration 

information via the DATE= parameter for a permanent file 

(DISP=KEEP). AS with ETSS/II, date protection 1S aiways 

assumed to be off for tempotary files (disp=delete or 

DISP=PASS). | 

Note; Files with the DATE= parameter will not be available 
anymore after a cold start. | 


A new supervisor generation option is provided in the SUPVR 
macro. The new keyword parameter is entitled ICCF. 


If ICCF=YES has been specified, a vector table is generated 
which iS pointed to by a new U4U-byte field added to the 
system communication region. The presence or absence of the 
address in the new field indicates whether or not the 
Supervisor has been generated with ICCF=YES. The vector 
table serves aS a communication area between the supervisor 
and VSE/ICCF. After VSE/ICCF initialization has verified 
that the supervisor has been generated with the required 
ICCF option, it places addresses of VSE/ICCF routines into 
the vector table for later use by the supervisor. At the 
end of the initialization process, VSE/ICCF places its PIK 
into byte 0 of the new field inthe system communication 
region to indicate that VSE/ICCF is active. 


During VSE/VICCF processing the vector table 1s in addition 
used for transferring status information from the supervisor 
to VSE/ICCF. Moreover the vector table contains information 
for the YVSE/ICCF termination process which iS now part of 
the DOS/VSE EOJ processiny. 


ICCF=YES also causes routines to be generated in the 
Supervisor which support storage protection of interactive 
partitions. These routines replace the special supervisor 
generation macros DTSPROTA and DTSPROTB of ETSS/SII. This 
means that the storage protect feature for interactive 
partitions is Standard for VSE/ICCF and the ETSS/II 
generation option PROTECT= is obsolete. 


In addition a new SVC-service routine is generated which 


allows VSE/ICCF to initialize the pages of a interactive 
partition and to set its storage protect key without 
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accessing and changing the page tables in the supervisor 
directly. 


Aliso if ICCP=YES has been specified and VSE/ICCF is active, 
the supervisor checks if an SVC-interrupt came from a 
program in the VSE/ICCF-partition. If the interrupt belongs 
to the VSE/ICCF-partition, the supervisor transfers control 
to the VSE/ICCF SVC-interrupt coutine addressed via the 
vector table. This mechanism makes the change of the SVC 
New PSW at VSE/ICCF initialization time obsolete, 


Moreover, by specifying ICCF=YES, a new SVC-service routine 
is generated which 18S cailed via SVC 82. SVC 82 replaces 
the SVC number used in ETSS/II which is either 175 ora 
humber specified via the VSE/ICCF generation parameter 
SVCNUM. The SVC-Service routine transfers control to an 
VSE/ICCF internal Service routine via the vector table. The 
VSE/ICCF yeneration option SVCNUM iS then obsolete. 

Finally with ICCF=YES a routine is generated in the program 
check handler of the supervisor which checks if a monitor 
call ainterrupt of class 4 came from a program in the 
VSE/ICCF-partition. If the interrupt belongs to the 
VSE/IcCCF-partition, the supervisor transfers control to the 
VSE/ICCF MC-interrupt routine addressed via the vector 
table. 

Monitor call class 4 is enabled at VSE/ICCF initialization 
time and disabled at VSE/ICCF shutdown time. The SVC 82 
routine contains functions to enable and disable the 
Monitor Call class 4. 


If ICCF=YES has been specified the following Supervisor 
generation options are forced: 


Nacro Parameter 
SUPVR NPARTS=3 1f NPARTS=1 has been 
Specified or the 
parameter has been 
omitted. 
AP=YES 
FOPT IT=YES 
OC=YES 
AB=YES 
PFIZ=YES 
CONFG FP=YES 


Note: **The following Supervisor generation options which 
are required by VSE/ICCF are standard starting with BOS/VSE 
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Macro Parameter 
FOPT PC=YES 


RELLDR=YES 
GETVIS=YES 


PIOCS BLKMNPX=YES 


In order to be consistent with DOS/VSE the GETVIS-area 
support for interactive partitions is now standard. 
Therefore the VSE/ICCP generation option GETVIS= is 
obsolete. Moreover, the minimum size of a interactive 
partition and its GETVIS-area are adjusted to DOS/VSE 
partition sizes. That is, the minimum Size of a interactive 
partition is now 128k and the minimum size of its 
GETVIS-area is 48K, 


AS the floating point Support in the supervisor is forced 
with ICCF=YES, the VSE/ICCF floating point generation option 
FP= becomes obsolete. | 


Aside from what has been described above various hooks have 
been introduced into the DOS/VSE control program, primarily, 
in order to cauSe control program services to access and 
update interactive partition control blocks in case the 
request came from VSE/ICCF. Services changed for that 
purpose are FETCH, LOAD, GETVIS, FREEVIS, etc. 


The Monitor Call class 4 has been reserved for VSE/ICCF. It 
has been introduced aS a general mechanism which allows 
VSE/ICCF to intercept DOS/VSE control program services which 
do not result in a SVC interrupt. Such services are usually 
those which are called from a user program by invoking a 
macro which does a branch and link to an SVA-routine. 

In case VSE/ICCF has to intercept such a service in order to 
do something Special for interactive partitions the invoking 
macro or the Service routine itSelf has to issue a Monitor 
Call instruction of class 4. AS the Monitor Call class 4 is 
enabled while VSE/ICCF is active a program check interrupt 
eccurs aS s00n aS such a service iS invoked. In case a 
interactive partition issued such a service request the 
Supervisor transfers control to the VSE/ICCF MC-interrupt 
routine which performs’ the Special handling for that 
service. | 


Control program services of DOS/VSE which are intercepted 
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Via that mechanism are the file label service (to be invoked 
by the LABEL macro) and the job-to-job communication service 
{to be invoked by the JOBCOM macro). 

The file label service has to be intercepted by VSE/ICCF in 
order to adapt the protect key such that the service works 
for interactive partitions as well. Also the labels have to 
be read into the label service's own buffers and then moved 
into the interactive partition (CCB and Iy0O areaS have to 
have the same storage key). If the label service's buffer is 
not large enough to contain a label, then VSE/ICCF is 
informed via a monitor call and cancels the job. The 
job-to-job communication service is not allowed to be used 
in interactive partitions. VSE/ICCF causeS a program ina 
interactive partition which issues JOBCOM to be canceled. 
DL/I when running ina interactive partition needs to know 
the interactive partition communication reyion address. 
Since the Svc 33 is costly DL/I loads the partition 
communication region address from low core. In an VSE/ICCF 
environment it will retrieve the interactive partition 
communication region by a monitor cali. 


INTERCEPT OF CHANGED SUPERVISOR SERVICES 


The intercept of the COMRG macro is extended such that the 
address of the interactive partition communication region is 
returned in the register the user has specified with the 
COMRG macro. 


The EXTRACT macro is intercepted by VSE/ICCF for all those 
services which cause partition related Information to be 
returned to a program. VSE/ICCF returns the corresponding 
information of a interactive partition. 

The LOAD/FETCH/GETVIS/FREEVIS/CDLOAD Svc intercepts are 
changed in such a way that they repeat the SVC and pass the 
interactive partitions communication region address to the 
Supervisor SVC routines. | | 

The USE/RELEASE SVC's are intercepted and recorded. AS long 
aS a interactive partition holds any resource, it may not 
loose its associated DOS/VSE task in order to be able to 
release it again. ~ | 

In general all SVCs which may not be used by a job executing 
in an VSE/ICCF interactive partition, and which are not 
already rejected by DOS/VSE are rejected by the VSE/ICCF SVC 
intercept routine. The job is cancelled with the DOS/VSE 
‘ILLEGAL’ SVC message. 7 
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VSE/ICCF 
S¥C macro 
QO ExXCP 
1 FETCH 
2 
3 
4 LOAD 
5 MVCOR 
6 CANCEL 
7 WAIT 
8 
9 LBRET 
10 SETIME 
11 
12 
13 
14 EOJ 
15 SYSIO 
16 SPXIT (Pc) 
17 #gXIT (Pc) 
18 STXIT (If) 
19 EXIT (IT) 
20 STXIT (O00) 
21 EXIT (OC) 
22 SEIZE 
23 | 
24 SETIME 
25 
26 
2/7 
28 EXIT (MR) 
29 WAITM 
30 QWAIT 
31 QPostT 
32 = 
33 COMRG 
34 GEMME 
35 HOLD 
36 FREE 
37 STXIT (AB) 
38 ATTACH 
39 DETACH 
4Q POST 
41 DEQ 
42 ENQ 
43 = 
Wy 
G5 
6 
U7 WAITF 
11.16 
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48 | | * l | 
Wy | | = | | 
50 | ] * | i 
57 | * | | | 
52 ?TTIMER | | * | | 
53 | | * | | 
54 | | * | i 
55 | i * | i 
56 | * l | | 
57 | * | | | 
58 | | * i | 
39 | | * | | 
60 | * | | l 
61 GETVIS | * l | | 
62 FREEVIS | * | { i 
63 | 2 | | { 
64 | * | | | 
65 CDLOAD | * | | I 
66 RUNMODE | * | | i 
67 PFIX | | % | | 
68 PFREE | | * | | 
69 REALAD | | * ] | 
70 VIRTAD | | * { | 
71 £xSETPFA | | * | | 
72 | | 6 I | 
73 | I * | | 
74 | | = | l 
75 SECTVAL | % | | | 
76 | | * | i 
77 I * ] I | 
78 CHAP mo % | | | 
79 l | * l | 
80 SETT | | * | i 
81 TESTT | [ * l | 
82 IccF Svc | * | | | 
§3 | | * | i 
By | * | | 
85 RELPAG | | | * | 
86 FCEPGOUT | | * | | 
87 PAGEIN | i * | | 
88 PIN | | * | | 
89 TPOUT | | * i | 
90 | { x l | 
91 l | * | l 
92 XECBTAB | | % | | 
93 xXPOST | | * | | 
94 XWAIT | | * ] i 
95 EXIT (AB) | | * i i 
96 STIXT (TT) | | * J | 
97 EXIT (TT) | | * | | 
98 | * | i | 
99 | * | | | 

100 | | * | | 
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101 | * | | | 
102 | | * | | 
163 | | * | | 
104 | * l | | 
105 | * | | i 
106 — | | . | | | 
107 | { * i I 
108 l f | | | 
109 | i | | j 
| | | { 


110 LOCK/UNLOCK 


Notes: 1. CANCEL ALL iS changed by VSE/ICCF to CANCEL 

2. Fast CCW-translation is skipped for interactive 
partitions 

3. EXCP with the parameter REAL is not supported in 
interactive partitions 

4. Programs which use DOS/VSE Service or access 
Supervisor tables which are not described as 
official interfaces in the 'DOS/VYSE Macro 
Reference’ manual may cause problems if they 
are executed in interactive partitions, 
although they run without problems in BOS/VSE 
batch partitions. 


Figure 3: List of Legal and Illegal svCs 


OPERATOR COMMUNICATION WITH VSE/ICCF 


For consistency and to Simplify the communication with 
VSE/POWER and ACF/VTAM, the VSE/ICCF operator commands are 
routed to the VSE/ICCF operator communication routine via 
the attention task and no longer via the 0C STXIT routine as 
in ETSS/II. It is no longer necessary for the operator to 
press the anterrupt key or to enter the MSG command, wait 
for an ETSS/II message, and finally enter the operator 
command. The operator can Simply enter the command in 
attention mode.The attention task transfers control to the 
VSE/ICCF operator communication routine addressed via the 
new vector table. | | 

The VSE/ICCF routine recognizes and accepts any VSE/ICCF 
command. If the command does not belong to VSE/ICCF control 
goes back to attention for further investigation of the 
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command. 


The UPSI Switch setting for the device type of the VSE/ICCF 
library will no longer be required nor supported. The 
device type will be dynamically determined by reading the 
label and extent information for the fixed name DLBL DISFILE 
Via the DOS/VSE SLA facility. A message will be issued and 
processing terminated if the DTSFILE was not supplied and/or 
the label access was unsuccessful. The DOS/VSE GETVCE 
facility will then be used to determine the device type for 
the given logical units. All device types must be the Same. 
The device related characteristics will be calculated and 
the DTF updated per the loygical-to-physical assignment. 


ANCEL OF INTERACTIVE PARTITIONS 


Currently jobs running in a interactive partition go through 
DOS/VSE end-of-job processing only if they end with an EOJ 
request, or if they are cancelled by DOS/YSE. If ETSS 
discovers an error Situation the jobs just don't receive 
control again. In this case user specified PC or AB exit 
routines do not get executed. 

In order to have any abnormal exit routine get control, to 
have DOS/VSE resources freed, to have the address space 
occupied invalidated, in an error Situation detected by 
VSE/ICCF control program, the jobs are forced through 
DOS/VSE end-of-job processing. this means, that now before a 
VSE/ICCF cancel message appears on the screen, a DOS/VSE 
cancel message will appear first. 


FIXED BLOCK MODE (EBM) SUPPORT 


The VSE/Icc Program Product will utilize the Fixed Block 
Mode {(FBM) of the E-SerieS machines for the VSE/ICCF 
library, SYSRES , and for the dynamic disk Space area when 
on FBM devices. Data 18S stored and retrieved to and from 
FBM peripheral storage devices in fixed blocks. # The 
addressing is by relative block number. VSE/ICCF will not 
be dependent upon the current 512-byte block size and will 
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use DOS/VSE GETVCE facility to retrieve such device related 
data as the block size, device block capacity, etc. By the 
use of FBM devices, VSE/ICCF is less dependent upon the 
physical device characteristics and can use the linear 
addressing scheme for any FBM device regardless of its block 
Size. The dynamic disk space area which allows the user to 
dynamically allocate disk space to his program is now 
Supported on FBM devices as well. 


It is also necessary for VSE/ICCF to adapt to an FBM SYSRES 
since VSE/ICCF accesses the system residence volume for 
loader processing. 


The current ETSS/II library file is a Single data set 
consisting of one or more extents residing on one or more 
devices. All logically related data records are chained 
together with backward and forward relative record pointers 
as shown: 


POINTER | 
cam ‘aie ataen wee eee ean wens see satin en | 


es eS 80-Byte Data Record---->< W-Eyte >< 4-Byte »> 
|-------------- ----- ~~-~------------- | ---------- |---------- | 
| 7 . | BACKWARD | FORWARD | 
| LOGICAL DATA RECORD } REL RCD |j REL RCD | 
| | POINTER | 
os | = i | 


Figure 4: VSE/ICCF Library Logical Record Forma 


‘Wanen sighs cote Unie nee aie wee A ND Ne er CCR. REE CLR PARED GEG: AOE TCR a vem: mene 


ict 


fhe first record in the VSE/ICCF Library file is the systen 
record which contains information such as the number of user 
profiles defined within the file, number of sub-libraries 
Within the file, and the start address of the broadcast 
records. Free area pointers are also contained in the 
system record. The free records are either allocated fron 
the free area at the end of the used portion of the file or 
from the free area chain of deleted records within the file 
area. 


The user profile records. which contain the user ID, 
password, security levei, library code, and statistics, 
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follow the system record. This is followed by the library 
header records which point to the first directory record for 
the specific library. The directory records are allocated 
as library members are created. They contain information 
relative to the iibrary member and a pointer to the first 
data record within the member. 


Each member consists of one or more 80-column data records 
With the 8-byte backward and forward pointers as shown 
above. | 


The VSE/ICCF library on a FBM device will maintain the same 
internal logical record format. For FSM, the number of 
cecords per block is calculated for the given control 
interval size and assigned to the NRECS= parameter. the 
NRECS= generation parameter of VSE/ICCF which resuits in 
the phySical blocking factor and buffer size for CKD 
processing is still required. The FBM phySical block size 
is fixed at 512-bytes and the implementation will be 
independent of this blocksize. The control interval size is 
Specified ona new VSE/ICCF generation parameter cCISIZE. 
The control interval is the unit of data transfer between 
Storajye and the FBM device, that is, the I/O buffer. The 
control interval consists of an integral number of physical 
blocks. The control information of the control interval is 
a Control Interval Definition Field(CIDF) and two record 
Definition Fields (RDF). The CIDF contains a 2-byte offset 
to the beginning of free space in the control interval 
followed by 2-byte free space length. The first RDF 
contains a control flag byte followed by 2-byte length field 
and the second RDF contains the number of records in the 
control interval. Since the VSE/ICCF libtary records are 
fixed at 88-Lytes, there will be just two RDF's and one CIDF 
per control interval as shown below: 


(----------------------- CONTROL INTERVAL---------------- > 
[n---------------- ~~----------------- |------ Teeenel been! lead 
| |n-------- _ |--------- II//////V BARI CH 
{|LOGICAL § | JLOGICAL jl//////| BD4oDi Ti 
[RECORD 1 [.ssesseeeeeeee RECORD 2311//////1 F 1 FID I 
| |--------- | |--------- IJUNUSED] 2.1 11 F | 

[--—] 

B K 


| l 
|}-FBM Block 1-|{-FBM Block 2-|-FEM Block 3-|-FBS 
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The characteristics of this example follows; 
Control Interval Size(Buffer Size) 2048 Bytes 
FBM Physical Block Size 512 Bytes 
VSE/ICCF Logical Record Size 88 Bytes 


In this example, the control interval consists of 23 
VSE/ICCF logical records (80 bytes of data and 8 bytes of 
control information), 14 bytes unused and 10 bytes of 
control information. No logical records can span control 
intervals. 


The control fields of the control interval in the above 
example would have the following values: 
Record Definition Field (RDr-2) 


Repiicated Record Count 23 
Record Definition Field (RDF-1) 
| Record Length 88 
Control Interval Definition Field (CIDF) 
Freespace Offset 2024 
Freespace Length 14 


mn ittne Ge SEN Eh ante SENS cme eum “om wenn a wa a <e ae EEE ERE ERE wena “EOE Carte endian adem eater weep 


The control interval size to be used for processing is 
Specified by a new CISIZE= keyword of the DITSOPTNS VSE/ICCF 
generation macro. A preliminary check of the CISIZE value 


is done at macro generation time. The CISIZE given must be ~ 


a multiple of the default 512-byte physical block size and a 
multiple of 2k 1f£f greater than 8k. The maximum value is 
32,768 and the default is 2048. This value also determines 
the size of the I/O buffers allocated; the number of buffers 
is determined by the NBUFS= value specified on the DTSOPTNS 
macro. 


A primary prerequisite necessary for FBM processing is the 
presence ot certain FBM DOS/YSE supervisor generation 
options. FBA must be given on the DISK= keyword of the 
generation macro PIOCS and via the IPL ADD command. The 
DFBA= keyword of IOTAB specifies the number of FBM drives. 
VSE/ICCF OPEN processing will determine the presence of FBS 
in the system by interrogating an option byte in the System 
Communications region. | 
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The VSE/ICCF library on FBM is to be created and initialized 
by a batch utility aS ait is done on current releases for 
count-Key-data devices. With the assignment of the library 
to an FBM device and the corresponding CLBL and EXTENT 
Statements 
( /f DLBL DTSFILE, 'ICCFFILE', xx/xxx,DAa 

// EXTENT S¥YSO012,nnnnnn,1,0,block-address, #-of-blocks ) 
giving the extents in FBM-block ranges, including the 
VSE/ICCF and DOS/VSE system generation options discussed 
above, the VSE/ICCF library file creation processing will be 
done. 


The device characteristics for the VSE/ICCF library will be 
obtained by using the GETVCE DOS/VSE Supervisor service 
facility to dynamically tetrieve the physSical block size. 
The control interval size given must be a multiple of the 
physical blocksize. If the control interval size does not 
meet this basic prerequisite, a message iS written and 
processing stopped. 


The VSE/ICCF CISIZE generated is placed in the DTFPH CISIZE 
field and an FBM OPEN for output issued. OPEN processing 
Will place the CISIZE in the FORMAT 1 label. LBRET is 
issued until all extents are processed. After returning 
from LBRET, it 1S verified that the CISIZE in the DTF is the 
Same aS the one given for VSE/ICCF generation. If 
different, it's likely that an inconsistent CISIZE override 
waS specified on the DLBL statement. A message 1S written 
and processing stopped. Otherwise, all FBM extents are 
preformatted with formatted control intervals. It's not 
allowed to have the library span CKD and FEM devices. After 
all extents are successfully preformatted and the file 
CLOSEd, the FBM library has been initialized. 


VSE/VICCF Processing During VSE/ICCF initialization or 
bring-up time the VSE/ICCF library is OPENed for processing. 
The FBM block EXTENTS and the CISIZE which is on the FORMAT 
1 label as a result of the utility creation process is 
returned by LBRET processing. If the returned CISIZE does 
not match the VSE/ICCF generated Size, an error message is 
written and VSE/ICCF initialization is terminated. 
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Since the control interval is the unit of data transfer, it 
is always a multiple of physical blocks and the extent is 
rounded by OPEN to contain a number of blocks that 15 an 
integer multiple of the number of blocks per control 
interval. ‘fhe upper physical block number of the extent 
will be rounded down to the last physical block of the last 
control interval of that extent. VSE/ICCF will construct an 
Extent Definition Block to map the logical block numbers to 
the physical block numbers of each extent. The forward and 
backward relative record chaining concept of the CKD 
VSE/ICCF library is continued in order to minmize logic 
changes to VSE/ICCF. VSE/ICCE FB library file 
characteristics such as control interval size, number of 
physical blocks per control interval, block size, logical 
records per control interval, and logical relationship to 
physical device aS contained in the VSE/ICCF constructed 
Extent Definition Block, are necessary to calculate relative 
record number-to- logical biock number and logical block 
number-to-relative record number, : 


The VSE/ICCF FBM Library tile characteristics in the example 
below are a 512-byte physical block size, 1024 control 
interval size, and eleven 88-byte VSE/ICCF Library logical 
recoras per control interval. (Logical records per control 
interval=. : 

(control interval size-(z2*length (rdf) tiength (cidf))/88) The 
library consists of three extents Spanning two FEN volumes. 
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First VSE/ICCF Library FBM Volume 
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Figure 06:3 VSE/ZICCF FBM Library Physical/Logical Relationship Ex. 
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Physical Logical Relative Relative 
Blocks Blocks — Byte Address Record Number 
Volume One 
First Extent 200-299 0=99 0-51199 0-549 
Second Extent 530-579 100-149 51200-76799 550-824 


Volune Two 
Third Extent 880-929 150-199 76800-102399 825-1099 


The physical 1/0 access to the VSE/ICCF library is located 
in two separate places, one for on-line processing and the 
other for batch processing. This interface iS also used to 
access the user Input, Print, and Punch areas which are 
located in the VSE/ICCF iibrary. Both physcial fale 
routines will be changed to include the necessary blocking 
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and de-blocking for FBM processing, and the usage of the new. 
FBM mode CCW's at the EXCP level. Write verification will 
be done aS per user specification. 


The batch utilities are to be adapted to process FBM devices 
in a Similar manner as count-key-data devices. 


To OPEN or CLOSE a data set successfully, it's necessary 
that the labels for the data Set are available in the label 
area. When a program running in a interactive partition 
issues an OPEN/CLOSE, YSE/ICCF receives control via an exit 
from the SLA routines. This VSE/ICCF routine reads the 
interactive partition labels, which were constructed by 
VSE/ICCF from the VSE/ICCF Job Entry /FILE statement, and 
returns a 00 return code and a file-id in LPL and label 
buffer to the requestor if the label is found. If the label 
was not found a non zero return code 1s set. Control is 
passed to SLA which goes to the user or keeps searching the 
disk area aS required. A Standard Label Access(SLA) 
facility is provided by DOS/VSE as a standard interface to 
the label areas, which is device independent to. the user. 
VSE/ICCF uses this SLA facility and thus remains independent 
of the label area format and whether it's on a CKD or FBS 
device. 


fhe access to the System reSidence directory of a FBM SYSRES 
is Changed. The VSE/ICCF LINKNGO facility is adapted to the 
DOS/VSE librarian directory format for accessing the 
relocatable library. 
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SUPPORT OF TTF 


(wetted any CRNED UERee ene same it, ee a ae ep 


The two terminal control systems supported by VSE/ICCF are 
CICS/DOS/VS and fTfIF. TIF is derived from the existing FDP 
ETSS/IL TCS which is a subset of MTCS/VS. ITF is tailored to 
the neeas of VSE/ICCF only. Except for VSE/ICCF no user 
application can run on TTF. TTF is dedicated to support the 
low-end user who has no needs for the complete set of data 
communication facilities offered by CICS/DOS/VS. 


TTP will be part of the VSE/ICCF program product whereas 
CICS/bDOS/VS has to be ordered separately. 


Characteristics of TTF 


py ie ane nee see cD ee oe ee ee ee cee ee em cen eh a ED eae an 


TTF provides a terminal control facility for VSE/ICCF only. 
fhe functions supported are in general the same as those of 
ETSS/II TCS. TTF handles all terminal control functions 
thru use of BTAM-ES. For support of hardcopy terminals it 
provides a message routing facility. 


[TTF is a sSingle-thread transaction system. That means, 
transactions are executed serially one after the other. For 
VSE/ICCF that means, processing of commands entered from 
various terminals iS serialized. This approach provides good 
response for a limited number of terminals. 


Because of the limited functions of TTF it has a much 


Smaller working set than CICS/DOS/¥YS and it is Simpler to 
install and to uSe than CICS/DOS/YS. 


> alee te EP see ve ete Co RE EE 


ITF supports only local terminals. It supports the display 
terminals 3278 in 3272 Model 2 mode, that means, screen 
Sizes with 1920 characters are supported. 3 


For a more detailed list of terminals supported by TIF see 
1140256 
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In order to run with TIF VSE/ICCF can be generated with the 
parameter SYSTEM=TTF. If omitted TTF is default. The 
‘parameter SYSTEM=MTCS which had to be specified to Cun 
ETSS/II on HTCS or on ETSS/II TCS will not be supported with 
the progran product. If VSE/ICCF uses CICS/DOS/SVS, 
SYSTEMN=CICS must be specified. 


fhe DOS/VSE Supervisor must be generated with BTAMN-ES 
Support. 
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SUPPORT OF NEW DISPLAY TERMINALS 3278 


VSE/ICCF supports the large screen sizes of new display 
terminals 3278 via CICS/DOS/VS only. Via TTF only the 
default size of 1920 characters of the new display terminals 
3278 stations 1S supported. 


Support for the new display terminals 3278 is provided only 
aS far aS new number of lines per screen 1S concerned, the 
linesize is always 80, the number of PF-keys remains 12, and 
the max. number of input lines 18S still restricted to 4. 


Generatio 
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Li the VSE/ICCF user wants to make use of the large screen 
Sizes of the 3278 Model 3 and Model 4 display stations, two 
tables of CICS/BOS/VS have to be generated in the following 
manner: . 


The corresponding terminal control table entries have to 
be yenerated With the new parameter 
ALTSCRN=(Llines,columns) which defines the large Screen. 
The program control table entries for all VSE/ICCF 
transactions except for 1$$5 and I$$6 have to be specified 
with the new parameter SCRNSZE=ALTERNATE. 


Usage of Large Screen $1Zes 


pe 


The /SET SCREEN and SET SCREEN commands are extended with 
respect to the 'd1l' and 'd2' parameters in order to support 
the large screen sizes. 


If the user works with the large screen Size of the 3278 
Model 3 display station the parameter ‘'d1', which indicates 
the startiny physical line number of the output area of the 
screen, may range from 3 to 28. The parameter 'd2', which 
indicates the number of lines the output area consists of, 
may cvange from 5 to 30. The parameter ‘rl', which indicates 
the logical begin of the outpat area on the Screen rather 
than the physical beyin may range from 1 to 26. The 
pacameter ‘'r2', which indicates the logical end of the 
output area may range from 5 to 30. 
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If the user works with the large screen size of the 3278 
Model 4 display station, the parameter 'd1' may range from 3 
to 39 and the parameter ‘'d2' may range fron 5 to 4i, 
parameter ‘ri* from 1 to 37, and parameter *‘r2* from 5 to 
ut. 


The VERIFY command is extended with respect to the ‘n2! 
parameter in order to support the large screen sizes. 

'n2' which is the total numper of lines to be displayed on 
the 3270 screen when LONG verify mode is set may range from 
5 to 28 for the large screen size of the 3278 Model 3 
display station and from 5 to 39 for the larye Screen size 
of the 3278 Model 4 display station. fhe default value for 
‘n2' is 28 for the large screen size of 3278 model 3 and 39 
for the large screen size of 3278 model 4&4. 


VSE/VSAM files (except Share option 4) may be Shared for 
concurrent processing between interactive partitions or 
between interactive partitions and DOS/VSE partitions. 

AMS is Supported to run in a interactive partition. 
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In the following the term prompters will be used instead of 
interactive usability aids. The prompters are intended to 
be an interactive and easy to use facility with which even 
an inexperienced uSerc can utilize the resources of an 
operating system. 


Depending on the kind of job he wants to do the user of the 
prompters needs to have only little knowledge of DOS/VSE. 
Especially he does not have to know detaiis on the various 
components of DOS/SVSE, e.g. the format and sequence of 
required control statements. He also should not have to 
deal with the characteristics of a certain device he wants 
to use, @.gjg. number of bytes per track on a 3340. 


the prompters will free the user from looking up those 
details in the corresponding manuals. 


The prompters are application programs or CLISTS running in 
a VSE/ICCF interactive partition. They act aS an interface 
between the user and DOS/VSE. The user enters his input from 
the terminal. The proapter then generates a LOS/SVSE job 
stream which may be saved aS a member in the VSE/ICCF 
library and/or submitted to a DOS/SVSE partition via 
VSE/POWER. The saved member may be password protected. 


The job streams generated by the prompters are syntactically 
correct but nevertheless the job may not run due to 
semantical errors which the prompters are not able to 
detect. In this case the uSer will receive a DOS/VSE error 
message. 


Prompter Structure 


All prompters are part of a general prompter structure. This 
Structure may be invoked at each of its levels. The levels 
of the structure represent a certain level of detail. Thus 
the top level gives a short introduction into the prompters 
and outlines the areas ( installation or daily work ) for 
which prompters exist. The next lower level indicates for 
which components of an area prompters are available. The 
next level lists the prompters available for a certain 
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component. The last level then is the actual prompter doing 
a special function. 
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Users 

The prompters are intended for uSers with some DOS/VSE 
knowledge, they are not intended for the completely 
inexperienced end user. 


It is assumed that the user knows which componentS exist in 
DOS/VSE and what their functions are. He does not need to 
know which control statements are required to execute the 
component function. He also should not have to deal with the 
Characteristics of an I/O device ( e.yjy. track capacity ) but 
he has to know which devices exist, what their addresses are 
and which device he wants to uSe. 


IMPLEMENTATION 


The prompters may be implemented by using any combination of 
the following facilities 


Assembler 
PLS 
VSE/ICCF CLIST facility 


depending on what fits best for a specific implementation. 


Prompters written via the CLIST facility reside as members 
in the VSE/ICCF library. Prompters written in assembler or 
PLS reside in the DOS/VSE core image library. 


Experience has shown that the VSE/ICCF CLIST language 1S not 
Suitable for long, complex or performance critical 
prompters. For this reason a set of assembler macros has 
been developed. Using these macros the prompter programmer 
will be able to: 


Write the prompter in assembler giving improved 
performance and greater flexibility. 
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Keep all language dependent output messayes and replies 
together in a meSsaye table and a reply table. This 
will facilitate the translation into other languages. 


Specify for each output message a ‘normal message and 
a ‘help messaye'. The macros will determine if the 
terminal user iS in ‘normal’ or 'fhelp* mode and 
transmit the required message. 


Permit the user to ‘page back’ to the previous 
prompting conversation. 


Redisplay cleared screen. 


Display all the input parameters to the user who will 
then be given the option of either changing selected 
parameters, or Saving the input in an VSE/ICCF library 
before continuing. The saved input may be used aS a 
model when next uSing the prompter. 


Reload Saved member. 
Execute VSE/ICCF commands. 


Prompter to prompter communication. 


Prompter bescription 


This section Summarizes which prompters will be provided for 
the supported components, 


AMS 
There will be 16 prompters which Supports a subset 
of full AMS. 
DOS/VSE System Utilities 
Backup and Restore System (Subset) 
Copy and Restore Diskette (subset) 
Fast Copy Disk ( CKD and FBM ) (Subset) 
vVroc Display (subset) 
Librarian 
A subset ot the librarian functions will be 
Supported. | 
Job Control 


Tne prompters for Job Control make the DOGS/VSE 


JCL, JECL and the VSE/ICCF JES transparent to the 
user, Tiere will be one prompter. 
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The prompters are designed and written for usage on display 
terminals. They will not be tested on typewriter terminals. 
The prompters aliso are designed for a full screen ({ uSing a 
nodel 2 size screen (1920 char.)), i.e. the user should not 
modify the size of his screen via /SET SCREEN when uSing a. 
prompter. 


The prompters are distributed with VSE/ICCF. Prompters 
written in assembler language and the prompter macros are 
distributed in the same file as the VSE/ICCF. The names of 
these file mdmbers all start with DTS. This tape is in 
DOS/VSE backup and restore format. | | 


11.36 IBM INTERNAL USE v4/05/79 


VOS/VSE PLANNING GUIDE Chapter 11.3 
Zi10- 9826 Volume I1 VSE/ICCF 


11.3.5 INTERFACES 


A problem program running in an ETSS/II FDP pseduo-partition 
can run unchanged in the VSE/ICCF program product version 
with the exception of the difference between CKD and FBS 
device characteristics, such as track versus block 
allocation. 


VSE/ICCF will support the Interactive Debuy FDP 5798-CKF. 
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In yeneral, all security features provided by ETSS/II are 
also available with VSE/ICCF, but there 1s one difference: 
if VSE/Access Control - Logging and Reporting is installed 
VSE/ICCF does not use its own data security tables but 
rather those of the DOS/VSE systen. The storage protect 
feature for interactive partitions 1S now standard. A 
permanent file for which the space has been allocated from 
the dynamic disk Space area may be date protected as with 
normal DOS/SVSE files. , | 
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The VSE/ICCF generation options are shown below in tabular 
form Summarizing any difterences between the FDP and the 
Proyram Product. Those denoted unchanged will generally use 
the same specifications as used in the base FDP. A detailed 
explanation for the changed, deleted and new parameters are 
included in this Section. 


DISOPINS UNCHANGED CHANGED DELETED NEW 
(N/C) (C) (dD) (N) 
ALTSEC N/C 
ALN2741 N/C 
CANKEY N/C 
CISIZE N/C N 
COMLIB W/C 
CRIJE N/C 
DEVICE D 
DISPKEY N/C 
EDFLAG N/C 
EDEND N/C 
FP D 
GETVIS D 
HCLINE N 
INTCOMP N/C 
INTDBG p 
INTRVAL n/c 
LOADPRYT N/C 
MAXINP D 
MULTEX D 
NAME D 
NDISKS D 
NBUFS C 
NRECS c 
NXTNTS N/C 
NUSRS N/C 
NPARTS N/C 
NPASKS N/C 
PATCH D 
PFKEY D 
PROTECT D 
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PGMRINP N/C 
PGMRLST N/C 

PGMRPCH N/C 

PGMRPIN N/C 

PGMRLOG NC 

POWRPCH N/C 

PRIMAXD 

PRTMAXH 

PRY 

PSIZE 2 i 
PWORK D 

PARTN c 

RLDBUFF D 

RDR N/C 

RDR2 N/C 

PCH N/C 

PRT D 

RPS D 

SPOOL , N/C 

SVCNUM D 

SYSTEM Cc 

TCNAME D 

TCUPSI w/e 

TCTOFS N 
TIOAOO Nyc 
PIOAUO N/C 
TIOAT7O 

T2740 

T2741 

13767 

T3270L 

T3270R 


tino woe 


The meaning of NBUFS has not changed, but the user must be 
aware that when using FBM devices the new CISIZE parameter 
determines the buffer size used by VSE/ICCF. Since the 
CISIZE is generally larger than the CKD bhuifer Size, care 
must be used when applying the NBUFS multiplier in order 
that the desired working set iS maintained. (see CISIZE) 


nrecs 
The meaning of NRECS for CKD processing has not changed. 


Its specification for an FEM device will be ignored 
because the CISIZE parameter determines the size the the 


11.40 IBM INTERNAL USE 7 O4/05/79 


2410-9826 


I/O area 


must 


for FBM devices 
device type is no longer 


DOS/VSE PLANNING GUIDE 
Volume IT 
(see CISIZE). Since 


likely device 


Characteristics ina ranye of 7-24. 


psize 


The minimum Size 


of an interactive partition 


Vittual memory. 


partn 


Chapter 11.3 
VSE/ICCF 


a specific 
specified(see DEVICE), the value 


correspond to the host type 


is now 128K 


The operand indicatiny the size of a interactive partition 
must not be less than 128K. 


system 


Specify 


CIcS for 


a CICS/DOS/VS system or TTF for 


MTCS/VS 1S no lonjer supported. The default is TTF. 


mp nen a ae a ae OR aE TR 


DEVICE 
FP 
GETVIS 
INTUSG 
MAXINP 
MULTEX 
NAME 
NOISKS 
PATCH 
PFRKEY 
PROTECT 
PRTMAXD 
PRIMA KKH 
PRTY 
PWORK 
RLDBUF 
PRT 

RPS 
SVCNUA 
TCNAME 
TIOA7O 
T2740 
T2741 
T3767 
T3270L 
T3270R 


V4 /05/79 


No longer required. 
Standard to be compatible with supervisor. 


Fixed name to be assigned by VSE/ICCF. 


Maintenance area to be standard. 


Now standard with [CCF=yes in supervisor. 


No longer required. 
No longer an option. 
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fhe control interval size is required to process the 
VSE/ICCF time sharing library residing on an FBM device. 
The CISIZE decimal value must be a multiple of the device 
physical block size which is 512 bytes, and a multiple of 2k 
if greater than 8k. The maximum vaiue 1s 32,768 and the 
default is 2048. This VWSE/ICCF generation CISIZE is placed 
in the FORMAT 1 label area by OPEN and it cannot be altered 
Since VSE/ICCF library record calculations and buffer size 
allocations are based on this value. The number of buffers 
allocated Via GETVIS is determined by the NBUFS= 
Specitication. The uSer must be cognizant of the CISIZE 
specification relative to its affect on performance and the 
VSE/ICCF working set. Namely, the CISIZE in combination 
With the NBUFS parameters and the related buffer control 
block areas determine the I/O area portion of the working 
set. The number of VSE/ICCF logical records per control 
interval can be determined by the following formula: Records 
per CI = (CISIZE-10)/88 where 88 is the VSE/ICCF logical 
record Size, and the variable is the CISIZE. 


For example, using the 2048 default CISIZE: 
(2048- (10))/88=23 Records per CI 
with 14 bytes unused. 


In the above example, a minimum of 23 logical records will 
be read or written per physcial I/O for the VSE/ICCF library 
on a FBM device. This corresponds to the NRECS= value used 
for for a CKD device which is ignored when CISIZE is given. 


HCLINE= 


In order to avoid that the 328X printers enter an additional 
blank line in case a line with the length of the printer's 
physical line size has to be written the physical line size 
has to be specified via the HCLINE parameter. [If the 
installation has printers with various physical line sizes 
or 1f terminals like 2740's are used as hardcopy printers 
HCLINE=NO should be specified. 


TCTOFS = 
The CICS/DOS/¥S user who has other programs which use the 


User Area in the TCT can specify the particular part of the 
area which VSE/ICCF is to use through this parameter. The 
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valid range is 0 through 255 and the value must be numeric. 
Several other programs which run under CICS/DOS/VS use this 
area for their own purposes. If any of theSe programs expect 
to pass values from one transaction to another where a 
VSE/ICCF terminal session could intervene, it is necessary 
to make sure that these applications do not use the Same 
area aS VSE/ICCF, Examples of such applications might 
include TEP (CICS/DOS/VS supplied or user’ own), performance 
Statistics, or page copy functions. 


EXTERNAL INITIALIZATION CHANGES 


‘ORES EET. cai SEERERS GRO SABLITD <P 


UPSI Switch Setting 


The UPSI switch setting for the device type of the VSE/ICCF 
library will no longer be required nor supported. (See 
Section 3.1.1.5) 


a came Git ae aD NEP ED CEN AE ie ED she afte MES We wee 


The dummy DLBL statements DTSDUMY, DTSDON1, DTSUUM2... are 
no longer required. 


Dynamic Disk Space Ate 


Unlike in ETSS/II where the dynamic disk space area had to 
be defined via two direct access data setS per extent, the 
dynamic space area iS no two multi-extent direct access data 
sets with the filenames DISDYNC or DTSDYNW 


Initialisation Option Replies 


The facility of predefined initialisation option responses 
has been extended. The replies are now read via DTFDI from 
SYSIPT and can therefore reside in a procedure or a SYSIN 
data stream on disk. In addition if a mistake 1S made in 
the predefined reply, the error is typed on the console, the 
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prompt repeated, and the answer read from the console. In 
addition, when replies are made via the SYSIPT facility only 
the important initialisation messages are logged on SYSLOG 
along with any error or warning messages. 


UTTLITY AND CONTROL STATEMENT CHANGES 


ARP RED aE HERES ED eet mani ETD EES ED RR enetn seem pany cent ue cape. ED wt: CRED weit eee en aah eaete ce EAN CEE eR CE - a a 


Generally, all control statements referencing devices will 
no longer require the device operand. Wherever the default 
device would have been the device Specified by DEVICE= on 
ETSS/II, VSE/ICCF will use the device type per the 
assignment of the DTSXXXX DLBL/EXTENT statements where 
applicable. It's recommended that these DLBL/EXTENT 
Statewents be permanently located oon DOS/VSE standard label 
area along w#ith the permanent SYS aSsSignment to avoid 
processing errors when VSE/ICCF determines the DASD device 
type. ? 


Removal of Submit to Batcn Facility without VSE/POWER 


A facility 1s provided in ETSS/II to flag library members 
for eventual batch execution. Then during a session, the 
computer operator or system administrator executes the 
DTSSELCT utility via the master terminal to punch all 
submitted jobs into the VSE/POWER internal reader queue. 
This facility was only retained in ETSS/II to be compatible 
With the previous versions and support will be removed from 
the program product. The program product will support the 
job submission and fcetrieval of printed output via the 
VSE/POWER PUTSPOOL/GETSPOOL /CTLSPOCL interface and via 
SEGMENT which is also included in ETSS/II. 


Control Statement Removal 


/SUBMIT no longer supported 


Utility to select jobs for batch processing (DISSELCT) is ho 
longer supported. Utility to clear submit to batch flag bit 
(D¥YSCLEAR) 1S no lonyer supported. 
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$$FBA accepted on /INSERT or GETFILE statement for file name 
of an input file created on an FBM device via SAM-FBM 

$SDISK will read data from the type of disk specified for 
the fixed name DLBL statement DTSBICH and the corresponding 
assignment 


File Maintenance Batch Utility 


UPSI Setting for Device Type. 


The UPSI Switch setting for the YVSE/YICCF 1library is no 
C 


control Statement Changes. All device related control 
statements such aS BACKUP, MERGE, RESTORe, INPUT, etc. will 
no longer require the device operand for the backup oF 


restore file. 


VSE/ICCF Library Conversion. To convert an VSE/ICCF library 
from a CKD to a FBM device it 1S necessary to use the bach 
library utility program (DTSUTIL). First, the CKD library 
is BACKUP'd to tape in one job. Then in a Separate DOS/VSE 
job with the appropriate FB< DLBL and EXTENT statements for 
the new VSE/ICCF library, a DTSUTIL FORMAT and RESTORE are 
necessary to format the FBM library and to restore the CKD 
library to a FBM device, The reverse process aisSo applies 
when converting from FBM to CKD. 


Link and Go Facility Name Change 


The VSE/ICCF utility which provides the capability for 
execution of object card images (called LOADER in the FDP) 
will be refered to aS LINKNGO in the PP, i.e. /LOAD LINKNGO 
instead of /LOAD LOADER. 


submit to Batch Facility 


Changes have been made to the submit to batch facility to 
allow DOS/VSE JCL and YSE/POWER JECL to be used in a member 
containing VSE/ICCF JES statements. This facility is 
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ptimarily for prompters but can be used by anyone.in the 
FDP, when a member contained ETSS JES, the first non-ETSS 
JES card image indicated the start of data. In the PP the 
first non-VSE/ICCF and non-DOS/VSE (beg. with // or * $$) 
indicates start of data. DOS/VSE type cards are passed 
unchanged to the output job stream. : 7 


The submit facility has also been changed to place an // 
ASSGN statement in the output stream after each // DLBL and 
// EXTENT which was converted from /FILE. This // ASSGN 
Statement will generically assign the sysnumber on the 
EXTENT to the volume on the EXTENT. 

The submit facility will also output the CISIZE operand on 
// DLBL statementS whenever it is encountered on the /FILE 
Statenent. ; 
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11.3.8 PERFORMANCE 
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For performance figuers please consult 
publication DOS/YSé PERFORMANCE GUIDE 
distributed via DAPS (2210-9823). 
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PRODUCTS (EQUIPMENT) 
The VSE/ICCF program product supports the Same hardware as 
ETSS/II and in addition the 4300 Processors and fFBM DASD 
devices supported by DOS/VSE and the 3278 terminals. 


The 'For VSE/ICCF' column is a required prerequisite for 
VSE/ICCF and the ‘For VSE/ICCF User‘ column indicates 
programs available to the user of VSE/ICCF. 


Controi Program gr VSE/ICCP For VSE/7iCcCr User 
DOS/SVSE SCP xX 
Advanced Functions 1.1 x 
POWER/VS 1.0 
VSAB/AMS 1.0 


by PS Pd 
aod 


Language/sort 
RPG If 

COBOL 

PL/I Optimizer 
FORTRAN 
VS/BASTIC 
Assembler X 2 
SORT/MERGE SM2 2.0 


ND ho 
e 
= © 


s 


Pd PS PM BS OS PS PS 


Telecommunications 
BTAM-ES (CICS/DOS/VS-TTF) X 3 
ACF/VTAM (CICS/DOS/VS)} X 3 


Data Base/Data Communications 
CICS/DOS/VS 1.4 X 
CICS/DOS/VS 1.4.1 (FBM DASD ICR) 
Notes: | 
Required for the submit-to-DOS/VSE facility 
Required for installation purposes only | 
Either CICS/DOS/VS or TTF is required 
DL/I DOS/VS MPS is not Supported 
DL/I DOS/VS batch iS Supported in interactive partitions 


UW bh A 
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VSE/ICCF is distributed in 9 track tape or disk format. The 
Shipment package has the following format: 
Vs Tape Layout 


File 1:3: Header Record 

File 2: VSE/ICCF Library File 

Pile 3: Trailor Labei 

File 4: Installation Sample Jobs (blocked 3440 bytes) 
File 5: Dummy 

File 6: Dummy 

File 7: Private Libraries (PCL, PRL, and PSi) 

File 8: Dummy 

File 9: Shipment History File 


2. Disk Layout 


FILE-ID CONTENTS 
A5746TS1.SYSCLB | Private Core Image Library 
A5746TS1.SYSRLB Private Relocatable Library 
A5746TS1.SYSSLE - Private Source Statement Library 
A5746TS1.HISTORY.FILE Shipment History File 
A5746TS1.ICCF.FILE VSE/ICCF Library file | 
A5746TS1.INSTJIOB VSE/ICCF Installation File 


The tape or disk contains all VSE/ICCF source components. In 
addition pregenerated components are available. Source and 
pregenerated material are stored on tape as DOS/VSE private 
libraries in RESTORE utility format. Jobstreams for 
assembling and linking VS£/ICCF components afLe also 
available. 
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11.4.2 VSEZICCP GENERATION 


INSTALLATION FLOWCHART 


e_————oeee—esdq 


JINSTALL| 
| ICCF | 
© ince ce camal 
Ce eee ete ee | ne se es ee ee 
| DEBLOCRK | | DEBLOCK | 
} INSTALL | <——-——-———-——. <?>, ---—----—--—-—-——> J INSTALL | 
{JOB PROM TAPE DISTR. MED. |} JOB FROM DISK| 
ees. eer eee er ea mee ROTO! | 
i : 
eee: ee SS i 
| RESTORE | | 
[TO DISK 1 ] 
, SE oa mE er I | | 
| | 
Uses See eee ee eee 
| 
el ener tee enna ee 
JRENAME DESIRED | 
{ICCF VERSION | 
See eee aks: ce eee eS 
oe re ee eee ee 
|DELETE NON—USED| 
JPART OF ICCF | 
estates ects ces. ae eae eo aeaad 
| 
a AE ip 
| INSTALLATION | 
| TARGET LIBS. { 
| i 
SYSTEM USER PRIVATE PRIVATE 
LIBS. LIBRARIES LIBRARIES 
Pr eo nn ee ge ee ee aaa RRR | Be ete ge nee ee ee ae 
|MSHP; | IMSHP: | JMSHP: 
| INSTALL... {| INSTALL... | J INSTALL... | 
| MERGE | | MERGE | |} ATTACH | 
a Alaa eee eto [NO MERGE | 
B | 


t_—----,;--—-—- 
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ae ac a 1 | 
}FORMAT AND | V 
{RESTORE |<--TAPE—-~<?> 
JjICCF LIB. | DISTRIB. MEDIUM 
SS Sa | 
] UISK 
| v 
; pn nnn 
L___-———————> |] VERIFY ICcCrF | 
[LIBRARY 
eee ae nee ae 
| 
| 
i 
| 
y 
(nnn 


JINITIAL INSTALLATICN COMPLETE | 
JPROCEED TO D&TAILED INSTALLATION | 
JIF ICCF IS TO BE CHANGED | 


: EDAD « EDY ALE” IIS LED CLE ALG, ART LLG ATID GEIS ER ORT OD SATE SD AUNT NNN “CRE VANE ETRE CLAD LEI GREED AESOP SERED: ELE SONY eee | 


A pregenerated version of VSE/ICCF will be available for the 
CICS/DOS/VS and TTF environment. 


If options given by the pregenerated system do not meet the 
users requirements he should alter the pregenerated systen 
instead of completely reassembling a new VSE/ICCF systen, 
Since this will save much assembly time. 


A VSE/ICCF system generation macro DfSSG haS been developed 
to support the user in this partial ofr complete 
regeneration. 

Before starting the regeneration it should be considered if 
the installation will allow a reconfiyuration at VSE/ICCF 
initialisation time. 

Since a lot of the VSE/ICCF generation options may be 
altered at initialisation time a fregenaration might be 
unessessary. | 
The following steps have to be performed to regenerate 
VSE/ICCF: | oO 


1. List VSE/ICCF options to be different from the ones in the 
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pregenerated version. 

2. Also list the options where the default differs from the 
specification in the pregenerated version. 

3. Specify the wanted options in the macro DISSG and assemble it. 
This will produce job control for the jobs to be performed. 

WY. Execute the joo straen build in the previous step. 


ARID settle cenit capa came ORES ae EN GRE GRP stmt mi i RN ie RID SERIA AUR AEA setae (RANI AED GLEE NCD ORI CRD noe ED REE <eORD ERS CORO CRS AMEE EE UES aD 


The following questions have to be answered to build up the 

VSE/ICCF library file. 

1. How much space should be allocated? 

2. Where should tne file be placed in relationship to the page 
data set and to work files? | 

3. How many potential library records should be allocated? 

4. How many actual libraries should be defined? 

5. How many potential user profile records should be allocated? 

o. How many actual user profiles Should be defined? 

7. How are the users to be naned? 

8. What passwords and profile characteristics should be given to 
individual users? 


RATE GENE VeRO “RO MRE EACEED > ty ae iin amen ema SD GH CN ae EEE One Aa: Ce 


The amount of Space to ailocate is calculated in terms of 
S8-byte records. The number of 88-byte records to be 
allocated may be approximated using the following formula: 


1000 + (N x D x M) + (U x 5000) 


N = the number of user profile records which have 
been defined and 

D = the average number of members which a 
given user will have in his library and 

M = the averaye length of a library member and 
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U = the number of users which may be logged on at 
one point in time. 


Example: For an installation with 4 terminalis, 10 user 
profiie records, an average number of 100 members in each 
users library of an average length of 150 records, the 
estimated file size would be 171,000 bytes. 


Where Should tne file be placed? 


It is important that the timesharing system library file be 
placed in an optimum location in relation to the paye data 
set and the compiler workfiles. 


How many potential Library Header Records? 
When the timesharing library file is initially formatted, 
the user mus specify the number of library header records 
to be allocated. This number represents a pool of records 
from which actual library header records will be allocated. 
[The specifications should pe laryer than the anticipated 
humber of libraries to allow for future library expansion 
Without having to reformat or restore the file. 


How many actual Library Header Records? 
Yhe actual number of library records to be defined depends 
on need. I[f 10 user profiles wili be entered into the 
system, no more than 10 actual libraries would be required 
unless all users had their own libraries and some users 
owned more than one library. 


Wow many potential User Profile Records? 
when the timesSharing library file 1s initially formatted, a 
pool of potential user profile records must be defined. 
Actual user profiles need not be specified for all potential 
profile record allocations. The prvfile record positions 
allocated but not defined represent room for expansion. 
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How many actual User Profile Records? 


It is entirely up to the installation how libraries and user 
profile records are allocated. 


How are the users named? 

What password and profile characteristics should be given to 
individual users? Each user whose profile will be added to 
the VSE/ICCF library file will be represented by a four 
Character identification code which must be specified when 
logging on. The codes are defined by the installation. They 
may relate to the user in a mnemonic or functional manner 
but this relationship is not regjguired. [In addition a log on 
password must be defined for each user identification. Also 
user characteristics have to be specified which may restrict 
users in their actions. 

The system administrator should have the lowest level of 
restrictions. 

Once these guestions have been answered, the installation of 
the timesharinyg system Should be able to specify the control 
cards necessary in order to define and initialize the 
library file. | | 


INTERACTIVE PARTITION WORKFILES 


In addition to the Space required for the timeshariny file 
itself there is some disk space needed for the interactive 
partition workfiles. For each interactive partition in 
which compilations are to be done a set of compiler 
workfiles 1S required. The number of workfiles depends on 
the compilers used. Workfiles can be placed in the dynamic 
disk space area, | 
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TERMINAL CONTROL CONSIDERATIONS 


VSE/ICCF makes use of either CICS/DOS/VS or TTF for its 
terminal control requirements. The generation of the 
terminal control system (CICS/DOS/VS or TTF) is completely 
independent of the VSE/ICCF generation. Thus the terminal 
control system you generate for use with VSE/ICCP wiil also 
run ina Standalone manner ina DOS/VSE partition. However 
certain functions must be included in the terminal control 
syste generation in order to allow VSE/ICCF to function 
properly. 


ERED ACT ota “eRe 2 ap aap 


Some of the CICS/DOS/VS tables are affected when installing 
VSE/ICCF. PPT and PCT must be reasSembled. DCT has to be 
reassembled if uSing hardcopy devices. TCT, 77° ..1u TDT may 
have to be reassembled. The necessary specifications are 
described in the manuals. The following CICS/YS modules 
must be present in the system: DCP, ICP, KCP, PCP, SCP, TCP, 
TDP and TSP. 


fTF 

The macros of TTF MTCSG and MTCTT and MTCFT have to be 
changed. The necessary entries are described in. the 
manuals. 
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The VSE/ICCF Program Product wili run on DOS/VSE only. 
VSE/ICCF as the ‘target system' will have several migration 
'sources!; 


1. CICS Source Program Maintenance On-line II (FDP) 
2. ETSS/II Field Development Program 


TTS RET OS cal wee ee cee am ae ame AT PI EN A 


The first difference when converting from SPM to VSE/ICCF is 
the library file. Formats, structure, blocking factors are 
different; therefore VSE/ICCF cannot access a SPM library 
file without modification. So a conversion will take place. 
In order to do it smoothly, some points are to be 
considered. 


fhe first approach is to read an SPM Back-up tape and modify 
it in order to get a tape which will be a valid input for 
the DbDTSUTIL program. The DTSUTIL utility program is a 
VSE/ICCF program which loads new members into the VSE/ICCF 
library file. Information to do this is documented in the 
DOS/VS Interactive ETSS/II SE-Guide (DAPS-# 2210-9824). 


The second approach is to use VSE/ICCF procedures in order 
to select conversationally the existing SPM programs to be 
transferred as VSE/ICCF members. 

An example of such a procedure iS given in the ‘'ICCF 
Reference and Installation Manual’. 
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fhe only way to have separate libraries in SPM 1s the 
facility to use different DOS files together with varying 
the first letter of the transaction identifier. 


In VSE/ICCF, the library file is logically divided in a 
number of libraries defined by the system administrator. 
These libraries (Public, Private, Common) have different 
level of protection and the uSer's access may be restricted 
by user profile. In addition to theSe restrictions an 
alternate security feature is available which gives even 
Stronger facilities. 


Member Protection 


CTD aR ED EEE GADD etnies TEMP CURED ANE QOUD CARR COIR MENON +S eate aa 


In SPM, an 8-character-password is available for 
member-levei protection. In VSE/ICCF, a tember may be 
protected by a 4-character-password. In addition, members 
may be public or private and the alternate security option 
has a direct effect on this protection. 


Multiple Copies of the Same Member 


In SPM, the member name is 8 characters long. Version and 
level allows you to have a lot of members with the same 
8-character name. In VSE/ICCF there 1S no version and level 
capability. However, the generation member group offers a 
Similar facility: when the tember name has up to 6 
Characters, it 1S possible to concatenate with it an hyphen 
and a 1 digit number. [It is so possible to have a maximum of 
ten versions with the Same 6-Character proygramname. The 
youngest one will be the -0 and oldest one, at least -1 and 
up to -9. 
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In SPM, compressed and extended members are in different 
logical libraries so that the Same (or the supposed Same) 
member may exist in both libraries, even with Same version 
and level. In VYSE/ICCF, a member may exist in compressed or 
expanded format, even intermixed in the Same generation 
member group, but is always unique. [f you want to Save an 
extended format of a compressed member, you have to do it 
explicitiy and save it under a new name (or new generation). 


Remark:*ft 1S possible to display a VYSE/ICCF coapressed 
member without expanding it. 


a a > i ae ae nayely sateam Wiehe node Sane semee SEED CED 20m SE 


In SPM, include and Select, Sequence and copy are the two 
manipuiation functions. 


In VSE/ICCF we have to make a difference between the input 
mode, the edit mode, and the execution node. 


In input mode, the command is /INSERT membername. In edit 
mode, the command 1S GETFILE membername. In execution mode, 
the command is /INCLUDE membername which haS the same effect 
as the <INCLUDE> of SPM. 


In SPM both are done by SPMEBATCH with appropriate control 
and parameter cards. 


VSE/ICCF provides the Same facility through the DISUTIL 
Program. ODTSUTIL performs archive and new file format 
functions, too. ItsS capabilities also include addition and 
deletion of libraries, library members, users, and broadcast 
records; printing and punching of members or libraries; 
displaying directory lists; display and clear accounting 
information. 
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Most SPM commands have VSE/ICCF equivalents, but the format 
is generally different. A first general remark is that SPM 
works with fixed format commands where VSE/ICCF allows 
variable format commands and a lot of abbreviations. Some 
VSE/ICCF commands are much more powerful than the related 
SPM commands. 


DISCOVER NEW FEATURES 


fhe edit facility will easily be understood and used by the 
new VSE/ICCF user. Execution in interactive partitionns 
needs some briefing and counseling. Use of tab- and 
PF-Key-setting, macro writing and procedures execution are 
other new valuable facilities. 


Dynamic space allocation within the VSE/ICCF work space via 
the /FILE statement must not be neglected. 


Automatic numbering of entered proyramsS is not performed in 
VSE/ICCF except in prompt mode for BaSIC and in linemode 
input in the editor. It is of course still possible to have 
hRumbered cards in programs but this is the result of a 
specific edit command (RENUM). Linemode editing will number 
all new input but will not renumber existing lines to 
squeeze in new Seguence numbers. 
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LOD Command 


The LOD facility of SPM has no eguivalent in VSE/ICCF. The 
LOD retrieves output from the VSE/POWER punch queue. This 
is possible because of a modification of VSE/POWER modules 
provided by SPM. 


In VSE/ICCF Rel. 1 it is only possible to display the 
VSE/POWER reader and punch queue, 


In SPM, there are two different commands (X01 and 201). In 
VSE/ICCF, the compression is considered aS an attribute of 
the member with the result that a /LIBRARY FULL display will 
Show all the library directories with all their attributes, 
included the compressed attributes whenever existing. 


TECHNICAL CONSIDERATIONS 


CN GY ED -Giiren Gitte CEE we ea ‘Sb ADE Gli Cle, Wie CRE GE CEN Ee te a a ae aa 


Both VSE/ICCF and SPM use dummy devices. Any conflict by 
specifying these devices will give unpredictible results. 
One of these experimented results is the inability to submit 
jobs to VSE/POWER neither in SPM nor in VSE/ICCF. The systen 
administrator must know that SPM scanS PUBS in ascending 
order looking for a specific reader type. VSE/ICCF just 
kKnowS by generation parameters which are "it's" dummy 
devices. So the conflict is easily avoided by yenerating a 
SPM valid dummy reader with address lower than the VSE/ICCF 
reserved reader addresses, 


Libraries created under ETSS/II are usable also under 
VSE/ICCF. For changes to generation options, initialization, 
commands, control statements and utilities please refer to 
the applicable sections of this chapter. 
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The following manuals and documentation will be available: 


S5$C33-6069 VSE/ICCF Messages 
LY33-9081 VSE/ICCF PLM 
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VSE/ICCF 
VSE/ICCF 


FORM NO. | SUBJECT | DESCRIPTION | 
> exe ate we wn san ise seme mane mast { oe wee cee wee nieee ane ane wee wom miei came wenn com [ota S Hee eS See eS Se Se See ee Se Sa eS Se Se eee eee | 
S$B21-2145 | ETSS/II | ETSS TERMINAL USER'S GUIDE | 
$B21-2331 ]}] ETSS/II |} ETSS FULL SCREEN EDITOR TERM. USER'S GUIDE | 
SB21-2146 | ETSS/II | ETSS TERMINAL USER'S SUMMARY | 
SB21-1982 | ETSS/ITI |} ETSS PROGRAM DESCRIPTION AND OPERATIONS | 
GC33-6066 | VSE/ICCF | VSE/ICCP G.1I.M. | 
SC33-6067 | VSE/ICCF |} VSE/ICCF Installation Reference | 
SC33-60068 | VSE/ICCF | VSE/ICCF Terminal USers Guide | 

| | 

| | | 
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12.1 INTRODUCTION 
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It is the aim of data Security to protect certain areas of 
an installation from unauthorized access. Therefore it is 
necessary to identify the resources and the users 
authorized. This means That one has to: 


* define user profiles and to 
* define resources to be protected. 


Now with a certain authorization method verify one against 
the other: 


* yerification 


After a verification has taken place security events have to 
be recorded and reports to be printed: 


* logging 
* Lreporting 


The different points reflect different components in the 
DOS/SVSE system: 

The definition of uSer profiles and resources 15 done via a 
VSE/ICCF table -DISECTAB- See 12.5.2. 

Verification is done by DOS/VSE for instance at OPEN time of 
files - see 12.4. 

Logging and reporting 18 done via the new program product 
DOS/VSE Access Control-Logging and Reporting - see 12.3. 
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12.2 SYSTEM REQUIREMENTS FOR DOSZVSE ACCESS CONTROL FACILITY 


DOS/VSE 

VSE/ADVANCED FUNCTIONS 

VSE/ICCF 

DOS/VSE Access Control-Logging and Reporting 
(Sort/Merge 5746-SN2 if wanted for sorting reports) 


* eK HK 
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12.3 DOS/VSE ACCESS CONTROL 
(3 746-XE7) 


The DOS/VSE Access Control-Logging and Reporting PP is part 
of the DOS/VSE Access Control Function offered to all users 
of DOS/VSE and designed to assist in auditing a DBOS/VSE data 
processing installation. 

It rejuires the ‘Compare and Swap’ hardware feature. 


Status > SPL 

Product Latest Release ei e0 

SIPO available 7Yes (Optional Feature) 
Installation License sN/A 

Pre Installation Test 2:30 Days 

Points Value 235 


* Logging of information about access related events to protect 
resources ( i.e. data sets, libraries and programs) to a 
sequential data set called the log data set file. 


* Logging 1S optional. 


* Logging 1s performed asSynchronousiy by a DOS/VSE subtask 
attached to VSE/ICCF. 


* Reporting provides a printout of selected data from the 
log data set for auditing purposes. 


* Selection criteria are provided to the reporting module 
during program execution by means of control statements. 


* Several reports corresponding to various selection criteria 
may be obtained in one program run. 


* Access event data may be archived on a tape and restored 
from tape for deferred reporting. 


* The log data set consists of two parts used alternatively: 


While one part 1s used for logging the other one may be used 
for reporting. 
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The Lojger iS responsible for writing all security related 
events out to the log data set. This data set consists of 
two parts used in flip/flop mode, and itS size can be 
predefined by the user. Input to the Logger will consist of 
a queue, Called log queue, residing in main storage acquired 
by the Logger usSing a GETVIS request. A pointer to the 
header of the lojging queue 1S contained in the Security 
Vector Table. For the maximum number of entries in the 
logging queue see 12.4.1. This number is also contained in 
the Security Vector Table. Elements will be added to this 
queue by all access control routines detecting a security 
event, and elements will be removed from the queue by the 
Logger after a log record has been written to the log data 
set. 


The foilowing types of events may be Logged: 


* data set access 
* library access 
* program access 


The type of event actually logged depends on the logging 
options in effect at the time when the event occurs. 
Furthermore, it depends on the logging options whether each 
of the specified events will be loyged or only security 
violations. For more information see 12.5.2. 


The Logger runs aS a SubtasSk attached automatically by the 
VSE/ICCF maintask 1f SEC=xx is generated in the Supervisor. 
Precautions are taken so that the Logger will not be 
attached several times. 


When performing a sShut-down operation for VSE/VICCF, this 
Will also mean a shut-down for the Logger. In a system with 
SEC=xx, VSE/ICCF will place a special request for the Logger 
anto the loyging queue and after termination of the Logger 
proceed with VSE/ICCF shut-dova 
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12.3.3 ACCESS CONTROL REPORTING 
While the Logger logs on one part of the log data set the 
reporting module may process the other part Simultaneously. 


The reporting module runs in a DOS/VYSE batch partition. 
When the log data set the Logger is currently using is full, 
it will be closed and the operator will be notified . The 
messaye displayed will contain the name of the log data set 
now full. The operator now has to initiate the reporting 
module, so that after processing of the log data set it will 
again be available to the Logger. 


The Reporting module performs four functions; 


* Print out selectively the content of the log data set giving a 
formatted list which will be used fur auditing purpose. The 
selection criteria are specified in a control statement 
provided at execution time and checked for validity by the 
program. Several reports corresponding to various selection 
criteria can be obtained in one program run. Since the data is 
not destroyed the program can be [run several times. 


* Dump the log data set from the disk onto a tape or disk, if 
needed for later processing or for archiving. 


* Restore the log data set from tape or disk onto disk, if needed 
for deferred processing. | 


* Clear the log data set by using a control statement. 
This will make the data set ready for further use by the Logger. 


In the SELECT control statement selection criteria for the 
reports can be specified. If a Specification is not yiven it 
is not taken into consideration for the selection. 


SELECT BEGIN=datel,tinel date as specified in the DOS/VSE 
system and time hh:mm:ss 
Where selection is to start 


END=date2,timne2 date and time where selection 
is to stop 
USERTD=namel,... uSer-1d causing the event 


EVENT=eventi,... PROGRAM, DATASET or LIBRARY 
can be specified 
DSNAME=namel,...« data set name 
PGMNAME=namel,... names of phases from CL 
VIOLATION=YES{NO security event or violation 
SORT=arg1l,... USERID, TIME, EVENT, RNAME 
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and VIOLATION can be 
Specified. (RNAME=resource name) 
PRINT=ALLISUMMABY complete list or Summary page 


The output 1S printed on SYSLST in form of one or several 
reports, depending on the number of SELECT Statements. Each 
SELECT statement corresponds to one rceport.Each report 
contains all the records corresponding to the criteria 
specified. The records are then printed in the order 
specified in the SORT parameter, or in the order they were 
recorded in the log data set, if no SORT parameter was 
specified. Each line contains the elements provided in the 
log data set: 

* time at which the security event occurred 

* date at wnich the security event occurred 

* event description indicator (security violation or not) 

* user identification, if supplied 

* user name, if supplied 

* logging reason 


* data set name or program name 


At the end a Summary report will be printed. 


12.6 | IBM INTERNAL USE 04/02/79 


DOS/SVSE PLANNING GUIDE Chapter 12.4 
2210-9826 Volume ITI Access Control 


SUPERVISOR HITS 
The supervisor will have a new generation option, which will 
generate the corresponding supervisor code. 


FOPT SEC=xx 
where xx 1S a value petween 10 and 32k-1. 


This value specifies the number of entries in the logging 
queue. Each entry in the logginy queue requires 8H bytes of 
storage. In installations with high logging activity (many 
protected resources and all accesses to be logged) a larger 
value should be specified than in installations with low 
logging activity. 


If a system is Started with SEC=xx then IPL sets up storage 
in the system GETVIS area for security related control 
blocks. 


The new load list SSVASEC contains the phases to be loaded 
into the SVA as Security Routine, Authorization Routine, 
Open Appendix Routine and the Access Control Table. 


IPL sets up pointers to the phases in the Security Vector 
Table. 


All SVA phases muSt be available during IPL. For the case 


that not all phases are available It is advisable to also 
generate a Supervisor without access control. 
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A new JCL statement iS introduced which contains the user 
identification and his password. This statement must 
immediately follow the // JCB statement. 


f/f ID USBER=XXXX,PWD=XXXXKA 


where USER is the user identifier and PWD a 3 to 6 
alphameric character password. Both parameters 
Will not be displayed on SYSLOG or SYSLST. 


An access control routine checks this information against 
the contents of the Access Control Table (DTISECTAB) and, 
depending on the result of this check, the job 1S allowed to 
run or will be cancelled. 


n jobs withoat an TD statement (for 
compatibility reasons), but the job 1s canceled as soon as 
an access to a protected resource is attempted. 


LZ EXEC Statement 


Before starting an execution, job control has to check, if 
the current user-id is allowed to work with the PCL 
currently assigned (if there 1S one), maybe from a previous 
job under another user-id. | 
This check will be done by issuing an OPEN for the PCL. 

If a access control check occurs, JCL will issue a message 
and allow the operator either to assign a new PCL or to 
unasSign the existing one and issue a new // EXEC. 


NOTE: This check at // EXEC time means,that the label 
information for the PCL must be available, else 
an OPEN label error will occur. 


Also a FETCH/LOAD Appendix Routine is part of anew SVC 


routine. After authorization checking during OPEN control 
is passed to this routine. 


12.8 IBM INTERNAL USE 04/02/79 


DOS/YSE PLANNING GUIDE Chapter 12.24 
2210-9826 Volume II Access Control 


ee ee ene ee ae nD este Maite ae means qm SN CRED wines CM amin oR ED ace 


When assigning a PCL, OPEN is done by job control. The used 
DTF has a DTF extension containing security related 
information. 

If a security violation occurs, then JCL issues a message 
and the operator has the chance either to assign another 
library, unassign the existing one or enter a new // ID 
Statement. 


LIBRARIAN HITS 


Whenever a private library is to be accessed the 
corresponding librarian program issues an OPEN. An exception 
are PCL's; they are opened at ASSGN time. Eefore issuing the 
OPEN, a DTFCP or DTFPH is set up. For access control 
checking the librarian DbTF's contain DTF extensions wiih 
pointers to the Authorization Parameter List containing for 
instance the READ-only or UPDATE indicator for the library 
access. This 18S transparent to the uSer. 


NOTE: AS system libraries are not opened they are not 
candidates for access control checking. 
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Labelled tape OPEN currently allows the operator to skip 
over label errors, or even process a labelled input tape as 
"UNLABELLED'. In a system with SEC=xx, this will not be 
allowed. fhe operator response 'TGNORE!® will not be accepted 
as a valid response to the following messages: 4111A, 4112A, 
G113D, 4115A, 48118D, 4119A, 4123D, 4125D, 4132D, 4133D. 

No logging will be performed for such attempted tape label 
check violations, 
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The $$3BOPEN and $$BOPENR transients have to check, if they 
are running ina system with SEC=xx. If so they have to 
branch to the OPEN Appendix Routine. 

This routine collects user and data set related information 
which then will be checked by the Authorization Routine 
against the contents of the Access Control Table. 
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42.5.1 ATTACH LOGGING TASK 
The logging task 18 attached as a subtask by the main task 
of VSE/ICCF. 


12.5.2 ACCESS CONTROL SABLE 
Resources to be protected must be defined in the access 
control table DISECTAB. The following types of resources can 
be protected: 
* Files | | 
~ all DASD files and labeled tape files defined b 
a file description macro DTFxx, or by appropriate 
file definition statements of the installations 
IBM compiler (s) 
- VSAM user files and VSAM catalogs 


* Private Libraries 


* Phases 
~ phases in the system core image library 
- phases in a private core image library 


Resources may also be protected by specifying a group name. 
Then all resources whose initial characters match that group 
name ate protected, which 1S eSpecially valuable for 
resources that have just been created and do not have an own 
table entry. 


NOTE: DTSECTAB itself must be protected by specifying 
an entry in the access control table for the 
phase name DTSECTAB. This entry should allow 
only the ainstallation’s security administrator 
to access that phase. 


In addition to the resources also the users must be 
specified in the access control table. 


The macro ODTSECTAB serves to specify and to generate the 
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access control table. The macro has to be assembled, link 
edited, and cataloged to the system core image library. 


DTSECTAB TYPE=USER]|GROUP|LIB]FILE]| PHASE, 
NAME=username]groupname Jlibname|] filename] phasename 
(,PASSWRD=password) | 
(, AUTH=YES | NO) 

(,ACC= (class,class,...U)) 
(, LOG= (class,class,...)) 
(,SUBTYPE=INITIAL| FINAL) 


TYPE defines the type of entry: user or resource 

NAME defines the name of uSer or resource 
for USER a 4 character user id 
for GROUP a 1 to 7 character group name 
for LIB a 1 to 44 byte file identification 
for FILE a 1 to 44 byte file identification 
for PHASE a 1 to 8 byte phase name 

PASSWORD 3 to 6 Characters if TYPE=USER 

AUTH=YES if TYPE=USER and Security admininistrator; 
can only be specified once 

ACC 1 to 32 access control classes; U is update 
and can only be specified for TYPE=O0SER 

LOG 1 to 32 logging classes; if not specified only 
access violations are recorded 

SUBTYPE first macro must contain INITIAL, last 

macro FINAL 


Here some examples; 


DISECTAB TYPE=USER, 
NAME=PAUL, 
ACC=(1-32,U), 
PASSWRD=XB3L25, 
AUTH=YES, 
SUBTYPE=INITIAL 


This user is the security administrator. Only one such entry 
is possible in the whole system. The ACC parameter is only 
specified for Clarification, since the security 
administrator indication (AUTH=YES) bypasses all access 
authorization checks. 


DTSECTAB TYPE=USER, 
NAME=OTTO, 
ACC= (1-8,25-32,0), 
PASSWRD=7BMC3U 


This user can access only resources defined with access 
control classes 1-8 and 25-32; he has read/update access to 
those with classes 25-32 and only read access for classes 
1-8. | 
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DTSECTAB TYPE=GROUP, 
NAME=USER, 
ACC=(1-8,25,32), 
LOG= (1-8, 25) 


This group entry allows uSers with matching access control 
classes to access files, libraries and phases that begin 
with the character string ‘USER’. 

The LOG specification causes all accesses for classes 1-8 
and 25 to pe logged; only access violations are logged for 
class 32. 


DTSECTAB TYPE=LIB, 
NAME=USER. PRIVATE.CIL, 
ACC=(1-8,32), 

LOG= (1-8) 


Note that this entry begins with the characters *USER* which 
is also defined aS a group entry. The access and log 
specification is a Subset of that group entry. 

However, for library access validation the library entries 
are searched first before the group entries. This means that 
users with access class 25 cannot access the library 
"USER.PRIVATE.CIL', even though access 1S permitted at the 
higher "USER*® group level. 


DISECTAB TYPE=PHASE, 
NAME=DITTO, 
ACC= (25-32), 
LOG= (25-31), 
SUBTYPE=FINAL 


The SUBTYPE specification has to be made for the first and 
last macro specified, 


Now for access control checking the user information and the 
resource information, both specified in CISECTAB, iS 
compared. 
This check is done in two steps: 
- A check for the match ot the access control class 
If there is a match for the access control class 
for the user and the resource, processing can 
continue. Otherwise a security violation is 
indicated. This check is done for all resources. 
- A check for a match of the READ/UPDATE indication. 
This check depends on the fact if the file was 
opened for input or update. If there 18S a match 
for the READ/UPDATE indication for the user and 
the resource, processing can continue. Otherwise 
a security violation is indicated. 
Note: access control distinguishes between read 
or update authorization for VSAM files only. 
For all other files or libraries update 
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authorization is required. 


The access control table isa SVA resident phase, loaded 
into the SVA at IPL time. It is possible to update and 
catalog DTSECTAB during processing and the system will 
always use the latest version. No re-IPL is necessary, as 
long as the SVA has sufficient space available for a new 
copy of the table. After a successful link editing of 
DTSECTAB in the BG partition, the processing of the next ID 
Statement makes the new version available. 


Sensitive information in the table will he scrambled to 
provide additional protection. | 
When creating the table with the macro DTSECTAB, the 
password specified in the ‘USER* entries is scrambled, and 
Will be displayed in the assembly listiny only in the 
scrambled format. 

When issuing the first /f ID statement after creating the 
table DISECTAB, or after loading a new version into the SVA, 
a special routine will automatically be invoked which will 
scramble all specified USER-IDsS and (a second time) all 
PASSWORDS in the SVA. 


3 DOS/VSE ACCESS CONTROL FUNCTION VERSUS VSE/ICCF 
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If DOS/VYSE has been generated with SEC=NO, VSE/ICCF uses its 
system program, load protection, and system file table for 
access authorization checking, if VSE/ICCF uSers access 
DOS/VSE resources defined in those tables for processing in 
an interactive partition. 


If DOS/VSE has been generated with SEC=xx, the three tables 
are ignored for access authorization checking Since the 
access authorization checking for DOS/VSE resources 1s done 
by using the Access Control Table (DISECTAH) in BDOS/VSE (the 
access request may originate from VSE/ICCF or DOS/YSE). 
Therefore, for a system with SEC=xx, all DOS/VSE resources 
to be protected must be Specified in DISECTAE. 


For VSE/ICCF users a user profile and password has to be 
specified under VSE/ICCF. [If users working under YVSE/ICCF 
in interactive partitions are also allowed to submit jobs to 
a DOS/VSE: batch partition they have also to be defined in 
DTSECTAB. . | 

Jobs submitted to the DOS/VSE batch can consist of: 


1. DOS/VSE job control 
2. VWSE/VICCF job entry statements. 
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in the first case the job is put into the VSE/POWER reader 
gueue as it is, and therefore must contain a valid ID 
Statement. | 

In the second case DOS/VSE JCL is created by VSE/ICCF and 
therefore the ID statement 1S also created by VSE/ICCF, 
which is possible through the user profile information 
available to VSE/ICCF. A verification check of that 
information was already done at VSE/ICCF log-on time. 
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12.6 VSEZVSAM IMPLICATIONS 


In a system that has the DOS/VSE Access Control Function 
installed,the REWIND option must be specified in the 
following VSE/VSAM commands: EXPORT, EXPORTRA, IMPORT, 
IMPORTRA, PRINT and REPRO. This means that no multifile _ 
volumes on unlabeled tapes are supported. | 
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* Any CPU supported by DOS/VSE 
* Disk devices: 
2314 
333U mod. 1 and mod. 11 
3340744 
3350 
FBM 
* Any device supported by DOS/VSE DIFMT may be used for 
backout the log data set for archiving purposes. 
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Performance of the logging facility is dependent on the 
following facts; | 


* number of requests for logging issued per second 


* priority of the logging task (i.e. priority of the 
Main task to which the logger is attached) 


* size of the loyging queue. 
If the logger has low priority and there are many requests 


for logging, the log queue may be frequently full, thus 
forming a bottleneck for the systen. 


The reporting program 1s run offline ina batch partition 
and thus does not have critical performance requirements. 
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13.1 INTRODUCTION 
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This chapter describes briefly the System IPO/E Release 1. 
In particular the DOS/VSE System IPO/E 1S covered. The VM 
based System IPO/E'sS are not addressed in this guide. 


SYSTEM INSTALLATION PRODUCTIVITY OPTIOCN/EXTENDED (SYSTEM IPO/E) 


DOS/VSE System IPO/E Option 1 5750-AAA 
Option 2 5750-AAB 
Option 3 5750-AAC 
VM System [PO/E 5750-AAD 


VM/DOS/SVSE System IPO/E Option 1 5S750-AAE 
Option 2 5750-AAF 


Status 
Release . 
System IPO/E Available b 


SPL program product 
1 


This product isS System IPO/E 


@e @©8 €6 68 86 


Installation Licence N/A 

Pre-Installiation Test N/A 

Planned Availability : DOS/VSE System IPO/E - 3979 
VM System IPO/E - 3979 


VM/DOS/SYSE System IPO/E - 4979 


The System IPO/ES are designed to reduce the time and skill 
level required to install, service and use DOS/VSE, VM/370 
and other selected licensed programs. System IPO/ES area 
new generation of software productivity options which expand 
installation assistance into both system tmanagement = and 
usage. They consist of preconfigured bases of pregenerated 
products with preapplied service, ready to uSe in specific 
operating environments. System IPO/ES are an extension and 
replacement of the successful and proven LOS/VS and VYM/370 
System IPOs and provide a Simplified, more productive 
interactive interface to assist customers in managing, 
servicing and using their system more effectively. 
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HIGHLIGHTS 


systen IPO/ES enhance user productivity,  systen 
serviceability and application growth by providing: | 


*  Preconfigured systems 
- for immediate installation and use. 
° Predefined procedures 
= for installation of features and application of 
preventive service across System IPO0/E base and 
selected featured components. 


° Interactive full-screen display and prompting. 


- for easier ant more pEOtuetiys communication with 
the system. | | 


° Online information 


- designed to reduce user prerequisite education and 
assist the new or infrequent uSer, | 


° Executable procedures 

- that reduce the need for detailed knowledge of 
VM/370 - system commands and DOS/SVSE control 
Statements. | 


° enhanced problem reporting facilities 


fe for effective management and control of systen/user 
errors. = | 


° Communication procedures 


- to assist block data transfer with remote systems. 
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The System IPO/ES are operational interactive systems, which 
utilize the Interactive Productivity Facility (IPF) in 
conjunction with VSE/ICCF in the DOS/VSE System IPO/E and 
CMS in the VM and VM/DOS/VSE System IPO/EsS. 

System IPO/ES comprise: 

° Pregenerated systems 


~ With preapplied service that have been designed for 
operation in specific environments, 


e Interactive procedures 
= or documentation with a resulting simplification of 
the installation of licensed program features and 
the servicing of DOS/VSE and VH/370 systems, 
utilizing the MSHP/PUT and PLC processes. 
° Full-~screen display, prompts and aids 


= that minimize the potential for errors in 
installing, Servicing and using the system. 


° Online information 
= in the form of explain facilities and a first use 
tutorial to increase or refresh knowledge of System 
IPO/E. 


° User oriented procedures 


= that provide system guidance and direction based 
upon CP/CMS commands and DOS/SVSE JCL. 


* Structured problem reporting systen 


~ based on IPCS to assiSt in APAR generation and 
easier problem management. 
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ad System communication procedures 


= implemented under DOS/VSE and YM to control/direct 
the flow of user data to renote systems. 


The DOS/VS System IPO/E is available in three options : 
OPTION 


Batch/Interactive/DB/DC 
Batch/Interactive/DC 
Batch/Interactive 


Ud KD ad 
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Each of the System IPO/ES consist of a preconfigured base 


13.4.1 BASE 

The base iS an integrated set of software components, 
pregenerated, preallocated with preapplied service and 
configured to a specific operating environment. A System 
IPO/E order resultS in a minimum Shipment of the integrated 
base components. 


Besides the base other components are available as optional 
features. Base and featured components receive synchronized 
service. Cross-component system validation via Installation 
Verification Procedures is performed on a system which 
includes both base and ali optional features, 
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DOS/VSE System IPO/E: 3 Options 
Option 1 Option 2 Option 3 
5750-AAA 5750-AAB 5750-AAC 
PROGRAM NAME NUMBER REL B/I/ B/I/DC B/1I 
LVL DB/LC 
BASE CONTENT 
DOS/VSE 5745020 X X X 
VSE/ADVANCED FUNCTIONS STUGXE8B 71.0 X 4 K 
VSE/IPCS 5745SA1 1.0 x x X 
VSE/ICCF 5746TS1 1.0 X X X 
VSE/POWER 5746XE3 1.0 X Xx x 
BTAE-ES S746RTDS 1.0 x x x 
VSE/SVSAM ST4UGAM2 1.0 X x x 
a PRODUCTIVITY 5748MS1 1.0 x X Xx 
CILITY 
seaaave 5S7TU6XX3 1.4 X X 
DL/I DBOS/VS 57460XX1 x 
FEATURES 
DATA DICTIONARY 5S7T46XXC yA 
DMS/CICS/VS-DOS 5S746KC4 1,0 x x 
VSE/PT 5796PLO p X x 
CICS/VS PA IT 5798CFP X X 
VSE/POWER/SR JIE S74HOXE3 1.0 x x X 
DOS/VSE RJE WORKSTATION 5746RGY x X 4 
Its 574U8BXX6 xX Xx 
VSE/DITTO 5746UT3 x x x 
COBOL —5T746CB1 x x K 
RPG If 5746RG1 3.0 x & X 
PL/I OPT./LIBS. 5736PL3 Xx a X 
PL/I OPT. 5736PL1 x A x 
PL/I RES. LIB. S736LM4 X Xx X 
PL/I TRANS. LIB. 5736LM5 X X X 
SORT/VS ST4U6SM2 x X X 
EP/V¥S (3705) ST4UTAG 1 X X X 
VSE/ACCESS CONTROL - ST4U6XET Xx x X 
LOGGING AND REPORTING 
VSAPL ST4UBAP 1 x x 


Note: 


Where a particular release level is not indicated, 


the 


release information will be Specified at System IPO/E 


availability. 
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13.4.4 DATA SECURITY: 


Customers using System IPO/Es Can use the security 
facilities provided by VSE/ICCF in DOS/VSE and the security 
facilities provided by VM/CMS in VM/370. Customer 
Management is responsible for the selection, implementation 
and adequacy of these facilities. 


IBM will include ACF/VTAM and ACF/VTAME as part of DOS/VSE 
System IPO/E and VM/DOS/VSE System LPO/E future releases, 
The first System IPO/E SNA support is planned for 1980. 
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Detailed information will 
General information manual 


be provided in the System IPO/E 
and the Planning Guide. 
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13. 6 SUPPORTED CONFIGURATIONS : 


WD en et Gi axgeb cemae aD EDS OGG GED CAD WEN KANE Cae CER “ane wally agi aGTE> EY wre? 


A series of user selectable confiyuration environments based 
on the DOS/YSE System IPO/E will be availakle to support the 
new IBM 4300 Processors and existing S/370 systems. 


° DOS/VSE System IPO/Es are designed for DOS/VSE users to 
Support commercial interactive applications in both 
Stand- alone and remote configurations. Supporting a 
wide range of hardware including the 4331 Processor, 
4341 Processor and comparable S/370. DOS/VS System 
IPO/ES are available in three options; 


OPTION MINIMUM SYSTEM SIZE 
1 Batch/Interactive/DB/DC 1 Megabyte 
2 Batch/Interactive/DC 1 Megabyte 
3 Batch/interactive -9 Megabyte 
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13.6. 


fms 
{cx 
i> 
img 
Ic 
ft 
> 
iso 


PREREQUISITE CONFIGURATION 


The prerequisite configuration is defined as the minimun 
required to install and service the BYSteM: ITPO/E - 


PRECONFIGURED SYSTEM 


This 1s defined as the maximum number of devices supported 
without systen regeneration. , a ee 


OPERATING ENVIRONMENTS 


The System IPO/Es will be validated in a aber “OE” operating 
environments, System IPO/E prerequisite and a series of 
preconfigured operating environments exist _ for 4300 
Processors and S$/370s, details of which will be available in 
the System IPO/E General Information Manual (GC20-1873). 
The customer is responsible for installing machine 
configurations of sufficient capacity to permit use of the 
products selected. 7 7 hive 
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An example of prerequisite and preconfigured environment for 
4300 Processors iS given below: 


DOS/VSE SYSTEM IPO/E —- EXAMPLE 


Hardware Prerequisite Preconfigured 
CPU 4331 1 1 
B/1L -> MB 22 MB 
ne 1.0 ME 1.0 MB 
DB/DC 1.0 MB 1.0 MB 
DASD 3310 Spindies 
B/I 4 8 
DC 5 8 
DB/DC 5 8 
Console 3278-2A 71 1 
Printer 3203-5 or 1 1 
3289-4 
Card 3505 1 4 


Reader or or 
Diskette #3401 
Card Punch 3525 
Tape 8809 
Terminals 3278-2 
3287 
Remote Display 
Stations 
COU CA or 370X 


OS —_ = © 
cond 
i= 


© 
~ 


Notes: 


1. 


Comparable S/370 configurations and DASD requirements are 
contained in the System IPO/E General Information Manual 
(GC20-1873). 

Prerequisite hardware configurations are the minimum required 
to install and service the System IPO/E. 

Preconfigured defines the maximum number of devices supported 
Without regeneration. System IPO/E supports expansion of 
system parameters up to the component product maximum, 

Card reader or diskette is included in the prerequisite 
configuration where it is required for hardware service. 

The individual programming components contained in the System 
IPO/ES are being provided in an unmodified form. fherefore, 
the preconfigured systems and/or the individual programming 
components may be tailored by the customer to obtain support 
for devices, e.g. 3262-1, 3370, which are otherwise supported 
by the proyramming components. Oo 


WESC BOE IBM Internal Use 13.11 


Chapter 13 DOS/VSE Planning Guide | 
System IPO/E Volume II 2210-9826 


See section 13.4.3 for details of the software supported in 
the base and optional features configurations. 
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The andividual programming components contained in the 
System IPO/ES are being provided in an unmodified forn. 
Therefore, the preconfigured systems and/or the individual 
programming components may be tailored by the customer to 
obtain support for devices, e.g. 3262-1, 3370, which are 
Otherwise Supported by the programming components. 
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PROGRAMMING SERVICE / CURRENCY 

The Programming setrvices or Programming Service 
Classification and Currency of each individual component 
contained in the System IPO/E iS unchanged from that stated 
in the availability notice of the individual component. 


DOCUMENTATION | 
Detailed information on the System IPO/ES is contained in 
the System IPO/E General Information Manual (GC20- 1873) 
Which will be available in March 1979 from EPC, Copenhagen. 
In addition, System IPO/E Planning Guides will be available 
prior to first customer ship. 


UPDATES 

The System IPO/Es will be updated at EPL with Service and 
new releases of its component products on a periodic basis. 
System IPO/ES are intended to eaSe inStaliation of new 
function. Thus, as new versions of products contained in 
System IPO/ES become available they may replace previous 
versions. Service will then continue for these products as 
Stated in the individual announcement letters for these 
products. 


RETAIN 

RETAIN entries will be available. The account PSR will 
Obtain RETAIN entries which should be reviewed by the 
account SE and PSR before installation of the System IPO/E 
and its associated licensed programs. 
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AVAILABILITY 


The System IPO/ES are available only to users of IBM CPUs. 
Questions concerning the Separate availability of the 
licensed program features of the System IPO/ES Should be 
directed to Country Business Practices. 


TERNS AND CONDITIONS | 
Each System IPO/E has the following terms and conditions 


° Prior to or concurrent with the ordering of a 
System IPO/E, each of the licensed programs in the 
System IPO/E base and the desired System IPO/E 
features must either be or have been separately 
ordered using the same customer numbers used to 

order the System IPO/E. System IPOG/E orders that 
do not meet this requirement will be rejected by > 


EPL. The customer must have also signed the 


License Agreement for IBM Program Products and be 
Specifically licensed for the appropriate licensed 
programs prior to ordering a System IPO/E. | 


* Should a customer wish to discontinue any product. 
that is within a System IPO/E base, normal license 
program discontinuance procedures apply. The user 
will not receive updated System IPO/ES. _ -_ 
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Your comments Please... 


Reply requested Name 
YesC) Job Title 
No CL) Address 


Thank you for your cooperation 


YOUR COMMENTS PLEASE . 7 


Your orments on the other side of this form will help us improve future editions of this publication. 
Each reply will ee carefully reviewed by the persons responsible t for cng and publishing this material. 
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